技能 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 建立一個登入畫面,包含電子郵件和密碼欄位、登入按鈕和忘記密碼連結。

預期結果:

  • 一個 Composable 函式 LoginScreen,包含正確標註的 TextField 元件用於電子郵件和密碼輸入
  • 一個具有 Material Design 3 主題樣式的 Button 元件用於登入
  • 一個用於忘記密碼連結的 TextButton,包含適當的點擊處理常式
  • 與 ViewModel 整合,使用 StateFlow 進行表單狀態管理
  • 遵循 Material Design 模式的輸入驗證和錯誤訊息

正在使用「android-native-dev」。 我該如何測試發出網路請求的 repository?

預期結果:

  • 使用 MockK 建立模擬 API 服務,對 suspend 函式使用 coEvery
  • 套用 MainDispatcherRule 替換 Main coroutine 調度器
  • 編寫測試案例,使用 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 專案

從頭開始為新的 Android 應用程式設定專案結構、設定 Gradle 建置檔案,並建立 Material Design 3 樣式。

遷移至 Jetpack Compose

在從 XML 基礎版面遷移至宣告式 UI 時,套用 Compose 最佳實踐、狀態管理模式和測試策略。

確保無障礙功能合規

實作適當的內容描述、焦點導覽、色彩對比度和觸控目標大小,以符合無障礙功能標準。

試試這些提示

建立新的 Android 畫面
建立一個用於使用者個人檔案頁面的 Jetpack Compose 畫面,包含個人檔案圖片、名稱、電子郵件和設定按鈕。請遵循 Material Design 3 規範。
設定 product flavors
為開發、測試和正式環境設定 Gradle product flavors,為每個 flavor 設定不同的 API 基礎 URL 和應用程式名稱。
編寫 ViewModel 測試
為 CounterViewModel 編寫單元測試,該 ViewModel 包含 increment、decrement 和 reset 函式。使用 Turbine 進行 coroutine 測試和 StateFlow 斷言。
實作無障礙導覽
設計具有適當內容描述、焦點指示器和 TalkBack 支援的無障礙底部導覽列。包含用於驗證無障礙合規性的檢查清單。

最佳實務

  • 在編寫業務邏輯之前,務必確保 ./gradlew assembleDebug 成功執行
  • 對 Compose 測試選擇器使用 testTag 修飾符,而非基於文字的 finders,以避免本地化問題
  • 將所有伺服器回應資料類別欄位標記為可為 null,以安全地處理不完整的 API 回應

避免

  • 在 Kotlin 中使用非 null 斷言運算子 (!!),當值為 null 時會導致程式崩潰
  • 在背景執行緒而非 Main 調度器中更新 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 composable 套用它們。
此技能涵蓋哪些測試框架?
此技能涵蓋 JUnit 和 Robolectric 用於本機單元測試、Espresso 用於儀器測試、UI Automator 用於跨應用程式測試,以及 Compose UI 測試框架。還包含用於 CI 測試的 Gradle Managed Devices。
此技能是否適合用於正式環境應用程式?
是的。此指導方針基於官方 Android 文件、Material Design 3 規範、Google Play 品質標準和 WCAG 無障礙功能需求。所有建議均遵循已確立的正式環境最佳實踐。