Android Jetpack
Jetpack是一套库、工具和指南的集合,旨在帮助开发者更轻松地编写高质量的应用程序。这些组件可以帮助您遵循最佳实践,免去编写样板代码的麻烦,并简化复杂的任务,让您可以专注于真正关心的代码。
Jetpack包含了androidx.*
包库,这些库与平台API解绑。这意味着它提供了向后兼容性,并且更新频率高于Android平台,确保您始终能够访问Jetpack组件的最新和最强大的版本。
我们的官方AAR和JAR二进制文件通过Google Maven进行分发。
您可以从Android Jetpack登陆页面了解更多使用信息。
贡献指南
关于通过GitHub进行贡献,请参阅GitHub贡献指南。
注意:目前通过GitHub的贡献工作流程仍处于实验阶段 - 目前仅接受对以下项目的贡献:
- Activity
- AppCompat
- Biometric
- Collection
- Compose Compiler
- Compose Runtime
- Core
- DataStore
- Fragment
- Lifecycle
- Navigation
- Paging
- Room
- WorkManager
代码审查礼仪
在为Jetpack做贡献时,请遵循代码审查礼仪。
接受的贡献类型
- 错误修复 - 需要在Android Issue Tracker中有相应的错误报告
- 每个错误修复都应该附带测试
- 修正拼写错误
- 更新文档
- 为当前未覆盖的领域添加新的测试
- 为现有库添加新功能,前提是功能请求的错误报告已被AndroidX团队成员批准
我们目前不接受新模块。
检出代码
前往入门文档了解更多关于环境设置和开发工作流程的信息!
持续集成
我们的持续集成系统会在新的更改合并时构建所有正在进行中(可能不稳定)的库。您可以手动下载这些AAR和JAR文件进行实验。
在进行更改之前设置密码和贡献者协议
在上传您的第一个贡献之前,您需要设置密码并同意贡献协议:
生成HTTPS密码: https://android-review.googlesource.com/new-password
同意Google贡献者许可协议: https://android-review.googlesource.com/settings/new-agreement
获得审核
- 运行repo upload后,打开r.android.com
- 登录您的账户(如果还没有账户,请创建一个)
- 添加适当的审核者(使用git log查找对您正在修复的文件进行了最多修改的人,或查看项目目录中的OWNERS文件)
处理二进制依赖
AndroidX使用git存储所有二进制Gradle依赖。它们存储在您检出的prebuilts/androidx/internal
和prebuilts/androidx/external
目录中。这些目录中的所有依赖项也可以从google()
或mavenCentral()
获得。我们存储这些依赖项的副本以实现封闭构建。您可以使用我们的importMaven工具引入新的依赖项。