<h1 align="center">Pokedex Compose</h1> <a href="https://opensource.org/licenses/Apache-2.0"><img alt="许可证" src="https://yellow-cdn.veclightyear.com/87312a0a/b3adfcc0-aa49-4ebb-98e5-102f0b66576b.svg"/></a> <a href="https://android-arsenal.com/api?level=21"><img alt="API" src="https://yellow-cdn.veclightyear.com/87312a0a/edaabdee-9f52-4bb8-8a5b-709424d0695f.svg?style=flat"/></a> <a href="https://github.com/skydoves/pokedex-compose/actions"><img alt="构建状态" src="https://yellow-cdn.veclightyear.com/87312a0a/62f3f65b-5b80-4160-96c6-bd1c9ac9bdac.svg"/></a> <a href="https://devlibrary.withgoogle.com/products/android/repos/skydoves-pokedex"><img alt="谷歌" src="https://yellow-cdn.veclightyear.com/87312a0a/e0991c12-4b6f-49d6-8561-75a52828e84f.svg"/></a> <a href="https://proandroiddev.com/exploring-dagger-hilt-and-whats-main-differences-with-dagger-android-c8c54cd92f18"><img alt="Medium" src="https://yellow-cdn.veclightyear.com/87312a0a/184a7c54-3b7c-42b9-91b2-4f520d4d0b42.svg"/></a> <a href="https://youtu.be/RG9ATodwbT4"><img alt="个人资料" src="https://yellow-cdn.veclightyear.com/87312a0a/339630d7-e0cf-4285-ae72-f0bcef76b480.svg"/></a> <a href="https://github.com/skydoves"><img alt="个人资料" src="https://yellow-cdn.veclightyear.com/87312a0a/c06a3395-aaf7-4d54-b07a-aac3cf443607.svg"/></a> 🗡️ Pokedex Compose 展示了使用 Jetpack Compose、Hilt、协程、Flow、Jetpack（Room、ViewModel）和基于 MVVM 架构的 Material Design 进行的现代 Android 开发。

[!提示] 如果你想查看 Pokedex 的 XML 版本，请查看 Pokedex 仓库。

下载

前往 Releases 下载最新的 APK。

技术栈和开源库

最低 SDK 版本 21。
基于 Kotlin 开发，使用协程 + Flow 进行异步操作。
Jetpack 库：
- Jetpack Compose：Android 的现代声明式 UI 开发工具包。
- Lifecycle：观察 Android 生命周期并在生命周期变化时管理 UI 状态。
- ViewModel：管理与 UI 相关的数据，具有生命周期感知能力，确保数据在配置更改时存活。
- Navigation：便于屏幕导航，结合 Hilt Navigation Compose 进行依赖注入。
- Room：构建带有 SQLite 抽象层的数据库，实现无缝的数据库访问。
- Hilt：用于依赖注入。
架构：
- MVVM 架构（视图 - 视图模型 - 模型）：便于关注点分离，提高可维护性。
- 仓库模式：充当不同数据源和应用程序业务逻辑之间的中介。
Retrofit2 & OkHttp3：构建 REST API 并实现分页网络数据获取。
Sandwich：适应性强且轻量级的封装 API 库，专为在 Kotlin 中处理 Retrofit、Ktor 和 Kotlin Multiplatform 的 API 响应和异常而设计。
Kotlin 序列化：Kotlin 多平台/多格式无反射序列化。
ksp：Kotlin 符号处理 API，用于代码生成和分析。
Turbine：用于测试 kotlinx.coroutines Flow 的小型测试库。
Landscapist Glide、animation、placeholder：一个可插拔、高度优化的 Jetpack Compose 和 Kotlin Multiplatform 图像加载库，使用 Glide、Coil 和 Fresco 获取并显示网络图像。
基线配置文件：通过在 APK 中包含类和方法的规范来提高应用性能，这些规范可以被 Android Runtime 利用。

技术内容

如果你对学习构建 Pokedex Compose 所使用的技术栈感兴趣，可以在下面链接的文章中找到详细信息：

Jetpack Compose 中的共享元素过渡：提供丰富的用户体验

架构

Pokedex Compose 遵循 MVVM 架构并实现了仓库模式，符合 Google 的官方架构指南。

Pokedex Compose 的架构分为两个不同的层：UI 层和数据层。每一层都有特定的角色和职责，概述如下：

Pokedex Compose 遵循应用架构指南中概述的原则，是架构概念在实际应用中的典范。

架构概览

每一层都遵循单向事件/数据流原则：UI 层向数据层发送用户事件，数据层向其他层提供数据流。
数据层独立于其他层运作，保持纯粹，不依赖于外部层。

这种松耦合架构提高了组件的可重用性和应用的可扩展性，便于开发和维护。

UI 层

UI 层包括负责配置用户交互界面的 UI 元素，以及管理应用状态并在配置更改期间恢复数据的 ViewModel。

UI 元素观察数据流，确保与底层数据层同步。

数据层

数据层由处理业务逻辑任务的仓库组成，如从本地数据库检索数据或从网络获取远程数据。该层设计为优先考虑离线访问，主要作为业务逻辑的离线优先仓库。它遵循"单一真实来源"原则，确保所有数据操作都是集中和一致的。

Pokedex Compose 是一个离线优先的应用，这意味着它可以在没有互联网连接的情况下执行全部或大部分基本功能。这种设计使用户能够可靠地访问核心功能，无论网络是否可用，减少了他们对持续更新的需求，并降低了数据使用量。有关如何构建离线优先应用的更多详情，可以访问构建离线优先应用。

模块化

Pokedex Compose 采用了以下模块化策略：

可重用性：适当模块化可重用代码，为代码共享创造机会，同时限制其他模块对代码的访问。
并行构建：每个模块可以并行运行，减少构建时间。
严格的可见性控制：模块限制暴露专用组件和访问其他层，防止它们在模块外被使用。
分散焦点：每个开发团队可以分配他们专用的模块，并专注于自己的模块。

更多信息，请查看 Android 应用模块化指南。

开放 API

Pokedex 使用 PokeAPI 构建 RESTful API。 PokeAPI 提供了一个 RESTful API 接口，可访问由数千行与 Pokémon 相关的数据构建的高度详细的对象。

觉得这个仓库有用吗？:heart:

通过加入这个仓库的 stargazers 来支持它。:star: 同时，也请在 GitHub 上 关注我，了解我的下一个创作！🤩

许可证

由 2024 skydoves (Jaewoong Eum) 设计和开发

根据 Apache License 2.0 版获得许可（以下简称"许可证"）；
除非遵守许可证，否则您不得使用此文件。
您可以在以下位置获得许可证的副本：

   http://www.apache.org/licenses/LICENSE-2.0

除非适用法律要求或书面同意，否则根据许可证分发的软件是基于
"按原样"分发的，不附带任何明示或暗示的担保或条件。
有关许可证下的特定语言管理权限和限制，请参阅许可证。