nowinandroid

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 21,682 Open GitHub ↗

완전히 Kotlin과 Jetpack Compose로만 구축된 완전한 기능의 안드로이드 앱

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![Now in Android](https://raw.githubusercontent.com/android/nowinandroid/main/docs/images/nia-splash.jpg "Now in Android")
[![](https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png)](https://play.google.com/store/apps/details?id=com.google.samples.apps.nowinandroid)
Now in Android App
==================
\*\*이 앱이 어떻게 설계되고 구축되었는지 [디자인 사례 연구](https://goo.gle/nia-figma), [아키텍처 학습 여정](docs/ArchitectureLearningJourney.md) 및 [모듈화 학습 여정](docs/ModularizationLearningJourney.md)에서 확인해 보세요.\*\*
이 저장소는 [Now in Android](https://developer.android.com/series/now-in-android) 앱을 위한 저장소입니다. 현재 \*\*개발 중인 프로젝트\*\* 🚧입니다.
\*\*Now in Android\*\*는 Kotlin과 Jetpack Compose로 완전히 제작된 완전한 기능의 Android 앱입니다. Android 디자인 및 개발 권장 사례를 따르며 개발자들에게 유용한 참고 자료가 되는 것을 목표로 합니다. 실행 중인 앱으로서, 정기적인 뉴스 업데이트를 제공하여 개발자가 Android 개발 트렌드를 최신 상태로 유지할 수 있도록 돕고자 합니다.
이 앱은 현재 개발 중입니다. `prodRelease` 변형 버전은 [Play 스토어에서 다운로드할 수 있습니다](https://play.google.com/store/apps/details?id=com.google.samples.apps.nowinandroid).
# 주요 기능 (Features)
\*\*Now in Android\*\*는 [Now in Android](https://developer.android.com/series/now-in-android) 시리즈의 콘텐츠를 표시합니다. 사용자는 최신 동영상, 아티클 및 기타 콘텐츠 링크를 찾아볼 수 있습니다. 또한 관심 있는 주제를 팔로우하고, 팔로우한 관심사와 일치하는 새로운 콘텐츠가 게시될 때 알림을 받을 수 있습니다.
## 스크린샷 (Screenshots)
![Screenshot showing For You screen, Interests screen and Topic detail screen](https://raw.githubusercontent.com/android/nowinandroid/main/docs/images/screenshots.png "Screenshot showing For You screen, Interests screen and Topic detail screen")
# 개발 환경 (Development Environment)
\*\*Now in Android\*\*는 Gradle 빌드 시스템을 사용하며 Android Studio로 직접 가져올 수 있습니다([여기](https://developer.android.com/studio)에서 최신 안정 버전을 사용하고 있는지 확인하세요).
실행 구성을 `app`으로 변경하세요.
![image](https://user-images.githubusercontent.com/873212/210559920-ef4a40c5-c8e0-478b-bb00-4879a8cf184a.png)
`demoDebug` 및 `demoRelease` 빌드 변형을 빌드하고 실행할 수 있습니다(`prod` 변형은 현재 공개적으로 사용할 수 없는 백엔드 서버를 사용합니다).
![image](https://user-images.githubusercontent.com/873212/210560507-44045dc5-b6d5-41ca-9746-f0f7acf22f8e.png)
시작하고 실행한 후에는 아래의 학습 여정을 참고하여 사용 중인 라이브러리와 도구, UI, 테스트, 아키텍처 등에 대한 접근 방식의 이유, 그리고 이 모든 다양한 프로젝트 조각들이 어떻게 조화를 이루어 완성된 앱을 만드는지 더 잘 이해할 수 있습니다.
# 아키텍처 (Architecture)
\*\*Now in Android\*\* 앱은 [공식 아키텍처 가이드](https://developer.android.com/topic/architecture)를 따르며 [아키텍처 학습 여정](docs/ArchitectureLearningJourney.md)에 자세히 설명되어 있습니다.
# 모듈화 (Modularization)
\*\*Now in Android\*\* 앱은 완전히 모듈화되었으며, 사용된 모듈화 전략에 대한 자세한 가이드와 설명은 [모듈화 학습 여정](docs/ModularizationLearningJourney.md)에서 찾을 수 있습니다.
# 빌드 (Build)
이 앱에는 일반적인 `debug` 및 `release` 빌드 변형이 포함되어 있습니다.
또한 `app`의 `benchmark` 변형은 시작 성능을 테스트하고 베이스라인 프로필(자세한 내용은 아래 참조)을 생성하는 데 사용됩니다.
`app-nia-catalog`은 \*\*Now in Android\*\*에 맞게 스타일이 지정된 컴포넌트 목록을 표시하는 독립형 앱입니다.
이 앱은 또한 [제품 맛보기(product flavors)](https://developer.android.com/studio/build/build-variants#product-flavors)를 사용하여 앱의 콘텐츠를 로드할 소스를 제어합니다.
`demo` 맛보기(flavor)는 정적 로컬 데이터를 사용하여 UI를 즉시 빌드하고 탐색할 수 있도록 합니다.
`prod` 맛보기(flavor)는 실세 네트워크 요청을 수행하여 백엔

kend 서버, 최신 콘텐츠를 제공합니다. 현재
공개된 백엔드는 없습니다.
일반적인 개발 시에는 `demoDebug` 빌드Variant를 사용하세요. UI 성능 테스트 시에는
`demoRelease` 빌드Variant를 사용하세요.
# Testing
컴포넌트 테스트를 원활하게 수행하기 위해 \*\*Now in Android\*\*는
[Hilt](https://developer.android.com/training/dependency-injection/hilt-android)를 사용한 의존성 주입을 사용합니다.
대부분의 데이터 계층 컴포넌트는 인터페이스로 정의됩니다.
그런 다음, (다양한 의존성을 가진) 구체적인 구현체들이 앱 내의 다른 컴포넌트에 해당 인터페이스를 제공하도록 바인딩됩니다.
테스트에서 \*\*Now in Android\*\*는 특히 목(mocking) 라이브러리를 전혀 사용하지 \_않는다\_는 점이 주목할 만합니다.
대신, Hilt의 테스트 API를 사용하여(또는 `ViewModel` 테스트의 경우 수동 생성자 주입을 통해) 프로덕션 구현체를 테스트 더블(test double)로 교체할 수 있습니다.
이러한 테스트 더블들은 프로덕션 구현체와 동일한 인터페이스를 구현하며, 일반적으로 추가적인 테스트 훅을 포함한 간소화된(하지만 여전히 현실적인) 구현을 제공합니다.
그 결과, 단순히 목(mock)에 대한 특정 호출을 검증하는 것보다 더 많은 프로덕션 코드를 실행하면서도 깨지기 쉬운 정도가 낮은 테스트가 만들어집니다.
예:
- 계측(instrumentation) 테스트에서는 사용자 환경설정을 저장하는 데 임시 폴더가 사용되며, 각 테스트가 끝난 후 삭제됩니다.
이를 통해 데이터 업데이트 흐름을 목 처리하는 대신, 실제 `DataStore`를 사용하고 관련된 모든 코드를 실행할 수 있습니다.
- 각 Repository의 `Test` 구현체들이 존재하며, 이들은 일반적이고 완전한 Repository 인터페이스를 구현하는 동시에 테스트 전용 훅도 제공합니다.
`ViewModel` 테스트는 이러한 `Test` Repository를 사용하므로, 특정 Repository 메서드가 호출되었는지 확인하는 대신 테스트 전용 훅을 사용하여 `Test` Repository의 상태를 조작하고 그에 따른 동작을 검증할 수 있습니다.
테스트를 실행하려면 다음 gradle 태스크를 실행하세요:
- `testDemoDebug`: `demoDebug` Variant에 대한 모든 로컬 테스트를 실행합니다. 스크린샷 테스트는 실패하게 됩니다(설명은 아래 참조). 이를 방지하려면 유닛 테스트를 실행하기 전에 `recordRoborazziDemoDebug`를 실행하세요.
- `connectedDemoDebugAndroidTest`: `demoDebug` Variant에 대한 모든 계측 테스트를 실행합니다.
> [!NOTE]
> `./gradlew test`나 `./gradlew connectedAndroidTest`를 실행해서는 안 됩니다. 이는 불필요할 뿐만 아니라 `demoDebug` Variant만 지원되므로 \_모든\_ 빌드 Variant에 대해 테스트가 실행되어 실패를 초래하기 때문입니다. 지원되는 Variant 외에는 다른 테스트가 존재하지 않습니다(향후 변경될 수는 있습니다).
## Screenshot tests
스크린샷 테스트는 앱 내의 화면이나 UI 컴포넌트의 스크린샷을 캡처한 후, 올바르게 렌더링되는 것으로 알려진 이전에 기록된 스크린샷과 비교합니다.
예를 들어, Now in Android에는 다양한 화면 크기에서 내비게이션이 올바르게 표시되는지 확인하기 위한 [스크린샷 테스트](https://github.com/android/nowinandroid/blob/main/app/src/testDemo/kotlin/com/google/samples/apps/nowinandroid/ui/NiaAppScreenSizesScreenshotTests.kt)가 있습니다([정상으로 알려진 스크린샷들](https://github.com/android/nowinandroid/tree/main/app/src/testDemo/screenshots)).
Now in Android는 특정 화면과 UI 컴포넌트의 스크린샷 테스트를 실행하기 위해 [Roborazzi](https://github.com/takahirom/roborazzi)를 사용합니다. 스크린샷 테스트를 사용할 때 유용한 gradle 태스크는 다음과 같습니다:
- `verifyRoborazziDemoDebug`: 모든 스크린샷 테스트를 실행하여, 정상으로 알려진 스크린샷과 비교하여 검증합니다.
- `recordRoborazziDemoDebug`: 새로운 "정상으로 알려진" 스크린샷을 기록합니다. UI를 변경하고 그것이 올바르게 렌더링되었음을 수동으로 확인한 후에 이 명령어를 사용하세요. 스크린샷은 `modulename/src/test/screenshots`에 저장됩니다.
- `compareRoborazziDemoDebug`: 실패한 테스트와 정상으로 알려진 이미지 간의 비교 이미지를 생성합니다. 이 이미지 역시 `modulename/src/test/screenshots`에서 찾을 수 있습니다.
> [!NOTE]
> \*\*실패하는 스크린샷 테스트에 대한 참고 사항\*\*
> 이 리포지토리에 저장된 정상으로 알려진 스크린샷들은 Linux를 사용하는 CI에서 기록되었습니다. 다른 플랫폼에서는 약간 다른 이미지를 생성할 수 있으며(실제로 그럴 가능성이 높음), 이로 인해 스크린샷 테스트가 실패할 수 있습니다.

ail.
Linux이외의 플랫폼에서 작업하는 경우, 이에 대한 우회 방법으로 작업을 시작하기 전에 `main` 브랜치에서 `recordRoborazziDemoDebug`를 실행하는 것입니다. 변경 사항을 적용한 후, `verifyRoborazziDemoDebug`는 정당한 변경 사항만 식별합니다.
스크린샷 테스트에 대한 자세한 내용은
[이 발표를 확인하세요](https://www.droidcon.com/2023/11/15/easy-screenshot-testing-with-compose/).
# UI
이 앱은 [Material 3 guidelines](https://m3.material.io/)를 사용하여 설계되었습니다. 디자인 과정에 대해 자세히 알아보고 디자인 파일을 얻으려면 [Now in Android Material 3 Case Study](https://goo.gle/nia-figma)를 참고하세요 (디자인 에셋은 [PDF로도 제공됩니다](docs/Now-In-Android-Design-File.pdf)).
화면과 UI 요소는 전적으로 [Jetpack Compose](https://developer.android.com/jetpack/compose)를 사용하여 빌드되었습니다.
이 앱은 다음과 같은 두 가지 테마를 지원합니다:
- 다이나믹 컬러 - [사용자의 현재 컬러 테마](https://material.io/blog/announcing-material-you)를 기반으로 하는 색상을 사용합니다 (지원되는 경우).
- 기본 테마 - 다이나믹 컬러가 지원되지 않을 때 미리 정의된 색상을 사용합니다.
각 테마는 다크 모드도 지원합니다.
이 앱은 [다양한 화면 크기를 지원하기 위해](https://developer.android.com/guide/topics/large-screens/support-different-screen-sizes) 어댑티브 레이아웃을 사용합니다.
[UI 아키텍처 여기서](docs/ArchitectureLearningJourney.md#ui-layer) 자세히 알아보세요.
# Performance
## Benchmarks
[`Macrobenchmark`](https://developer.android.com/topic/performance/benchmarking/macrobenchmark-overview)를 사용하여 작성된 모든 테스트는 `benchmarks` 모듈에서 찾을 수 있습니다. 이 모듈에는 Baseline profile을 생성하기 위한 테스트도 포함되어 있습니다.
## Baseline profiles
이 앱의 baseline profile은 [`app/src/main/baseline-prof.txt`](app/src/main/baseline-prof.txt)에 위치해 있습니다.
여기에는 앱 실행 중 거치는 핵심 사용자 경로의 AOT 컴파일을 활성화하는 규칙이 포함되어 있습니다.
baseline profile에 대한 자세한 내용은 [이 문서](https://developer.android.com/studio/profile/baselineprofiles)를 읽어보세요.
> [!NOTE]
> 앱 시작을 변경하는 코드를 건드리는 릴리스 빌드의 경우 baseline profile을 다시 생성해야 합니다.
baseline profile을 생성하려면 `benchmark` 빌드 변형을 선택하고 AOSP Android Emulator에서 `BaselineProfileGenerator` 벤치마크 테스트를 실행하세요.
그런 다음 에뮬레이터에서 생성된 baseline profile을 [`app/src/main/baseline-prof.txt`](app/src/main/baseline-prof.txt)로 복사합니다.
## Compose compiler metrics
Compose 컴파일러 메트릭을 가져와 분석하려면 다음 명령을 실행하세요:
```bash
./gradlew assembleRelease -PenableComposeCompilerMetrics=true -PenableComposeCompilerReports=true
```
보고서 파일은 [build/compose-reports](build/compose-reports)에 추가됩니다. 메트릭 파일도 [build/compose-metrics](build/compose-metrics)에 추가됩니다.
Compose 컴파일러 메트릭에 대한 자세한 내용은 [이 블로그 포스트](https://medium.com/androiddevelopers/jetpack-compose-stability-explained-79c10db270c8)를 참고하세요.
# License
\*\*Now in Android\*\*는 Apache License (Version 2.0)의 조항에 따라 배포됩니다. 자세한 내용은 [license](LICENSE)를 참고하세요.

nowinandroid

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README