技能 android-native-dev
📦

android-native-dev

低风险 ⚙️ 外部命令

使用 Kotlin 和 Compose 构建 Android 应用

Android 开发需要遵循多项指南并避免常见陷阱。本技能提供 Material Design 3、Kotlin 最佳实践、Jetpack Compose 模式、无障碍要求和测试策略的统一参考。

支持: Claude Codex Code(CC)
🥉 72 青铜
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“android-native-dev”。 使用 Jetpack Compose 创建带有邮箱和密码字段、登录按钮和忘记密码链接的登录屏幕。

预期结果:

  • 一个带有所用正确标签的 TextField 组件的 LoginScreen 可组合函数,用于邮箱和密码输入
  • 一个带有 Material Design 3 主题的样式化登录按钮
  • 一个带有适当点击处理程序的忘记密码链接 TextButton
  • 使用 StateFlow 进行表单状态管理的 ViewModel 集成
  • 遵循 Material Design 模式的输入验证和错误消息

正在使用“android-native-dev”。 如何测试发出网络调用的 repository?

预期结果:

  • 使用 MockK 创建带有 coEvery 的模拟 API 服务(用于 suspend 函数)
  • 应用 MainDispatcherRule 替换主协程调度器
  • 编写验证缓存行为的测试用例,使用 coVerify 检查调用次数
  • 使用 Turbine 测试 Repository 发出的 StateFlow

安全审计

低风险
v1 • 4/16/2026

This skill is a documentation-only markdown reference guide for Android native development. The static analyzer flagged 422 patterns across 10 files, but all are false positives. The external_commands findings (265 locations) are markdown code fences showing standard Gradle build commands (e.g., ./gradlew), not actual shell execution by the skill. The weak cryptographic algorithm findings are triggered by design guideline terminology, not actual crypto code. The network, filesystem, and env_access findings point to code examples in documentation, not runtime behavior. The skill contains no executable code, no network requests, no credential handling, and no data exfiltration patterns. The only risk is that the skill instructs users to run standard Android build commands (gradlew), which is the intended and legitimate use of this development guide.

10
已扫描文件
3,397
分析行数
2
发现项
1
审计总数
低风险问题 (1)
External Command References in Documentation
The skill documentation includes examples of Gradle build commands (./gradlew) that users may execute in their own projects. These are standard Android build tooling commands, not arbitrary shell execution. The skill itself is a markdown reference and does not execute commands directly.
审计者: claude

质量评分

45
架构
100
可维护性
87
内容
50
社区
88
安全
74
规范符合性

你能构建什么

启动新的 Android 项目

设置项目结构,配置 Gradle 构建文件,为新的 Android 应用从头建立 Material Design 3 样式。

迁移到 Jetpack Compose

在从 XML 布局迁移到声明式 UI 时应用 Compose 最佳实践、状态管理模式和测试策略。

确保无障碍合规

实施适当的内容描述、焦点导航、色彩对比度和触摸目标尺寸,以满足无障碍标准。

试试这些提示

创建新的 Android 屏幕
使用 Jetpack Compose 创建用户资料页面,包含资料图片、姓名、邮箱和设置按钮的新屏幕。遵循 Material Design 3 指南。
设置产品风格变体
配置 Gradle 产品风格变体,用于开发、预发布和正式环境,每个风格有不同的 API 基础 URL 和应用名称。
编写 ViewModel 测试
为具有增量、减量和重置功能的 CounterViewModel 编写单元测试。使用 Turbine 进行 StateFlow 断言的协程测试。
实现无障碍导航
设计一个具有适当内容描述、焦点指示器和 TalkBack 支持的无障碍底部导航栏。包含无障碍合规验证清单。

最佳实践

  • 在编写业务逻辑前始终确保 ./gradlew assembleDebug 成功
  • 使用 testTag 修饰符进行 Compose 测试选择器,而不是基于文本的查找器,以避免本地化问题
  • 将所有服务器响应数据类的字段标记为可空,以安全处理不完整的 API 响应

避免

  • 在 Kotlin 中使用非空断言操作符(!!),这会在值为空时导致崩溃
  • 从后台线程而非主调度器更新 UI 状态
  • 使用 Android 保留名称如 background、icon 或 view 作为自定义资源标识符

常见问题

本技能针对哪个 Android SDK 版本?
本技能涵盖适用于现代 Android 版本的一般 Android 开发实践。具体的 SDK 目标应根据项目需求设置,建议大多数应用的最低 SDK 为 21 或更高。
本技能是否支持 XML 和 Jetpack Compose?
是的。本技能涵盖传统 XML 布局和现代 Jetpack Compose 开发。Compose 建议用于新开发,但包含 XML 指导以供现有项目使用。
本技能能否从零开始创建新的 Android 项目?
本技能为项目配置(包括 Gradle 配置、文件结构和初始依赖项)提供指导。它不会自动生成构建文件,但会引导你完成所需的步骤和配置。
本技能如何处理 Material Design 3 动态色彩?
本技能根据用户壁纸偏好推荐 Material Design 3 动态色彩系统。它涵盖 M3 色彩方案标记以及如何通过 MaterialTheme 可组合项应用这些标记。
本技能涵盖哪些测试框架?
本技能涵盖用于本地单元测试的 JUnit 和 Robolectric,用于插桩测试的 Espresso,用于跨应用测试的 UI Automator,以及 Compose UI 测试框架。它还包括用于 CI 测试的 Gradle 托管设备。
本技能是否适合生产应用?
是的。本指南基于官方 Android 文档、Material Design 3 规范、Google Play 质量标准以及 WCAG 无障碍要求。所有建议都遵循成熟的生产最佳实践。