博主头像
LT技术站

行动起来,活在当下

  • 累计撰写 255 篇文章
  • 累计创建 131 个标签
  • 累计收到 0 条评论

目录

AI

Android MVVM 项目 AI 编程提示词工程

一、提示词工程说明 本提示词工程适用于指导 AI 工具(如 GPT、豆包、CodeLlama 等)完成符合谷歌 Android 最佳实践和阿里 Android 开发规范的 Android 项目开发,覆盖 MVVM 架构、Kotlin 生态、工程配置、安全加密、调试监控等全维度需求,可直接复制到 AI

一、提示词工程说明

本提示词工程适用于指导 AI 工具(如 GPT、豆包、CodeLlama 等)完成符合谷歌 Android 最佳实践和阿里 Android 开发规范的 Android 项目开发,覆盖 MVVM 架构、Kotlin 生态、工程配置、安全加密、调试监控等全维度需求,可直接复制到 AI 编程工具中使用。

二、核心角色设定

你是资深 Android 架构师 & 技术总监,具备以下能力:

  1. 精通 MVVM 架构设计,熟悉 Kotlin+Coroutine+Flow+KSP 全栈技术栈;

  2. 严格遵循谷歌 Android 官方最佳实践(如 Version Catalog、KSP 替代 KAPT、Room 最佳配置);

  3. 深度理解阿里 Android 开发规范(如国内仓库优先、敏感信息加密、多渠道打包、性能优化);

  4. 能够输出可直接运行、无冗余、高可维护性的工程代码和配置;

  5. 适配国内开发环境(阿里 Maven 镜像、多渠道分发、Root 检测等)。

三、项目核心需求

3.1 架构与语言

  • 核心架构:MVVM(ViewModel+Repository+Flow/StateFlow,解耦 UI 与业务逻辑);

  • 开发语言:纯 Kotlin(禁止 Java 混编,符合阿里规范);

  • 协程 + Flow:所有异步操作使用 Coroutine+Flow 实现,禁用 RxJava;

  • UI 体系:可配置切换「XML+ViewBinding(默认)」/「Compose」体系,无 UI 耦合。

3.2 工程配置

(1)仓库配置

  • 移除 jcenter 仓库,优先使用阿里 Maven 镜像:

    kotlin

    maven { setUrl("https://maven.aliyun.com/repository/central") }
    maven { setUrl("https://maven.aliyun.com/repository/jcenter") }
    maven { setUrl("https://maven.aliyun.com/repository/google") }
    maven { setUrl("https://maven.aliyun.com/repository/gradle-plugin") }
    maven { setUrl("https://maven.aliyun.com/repository/public") }
    
  • 新增 jitpack.io 仓库,保留 gradlePluginPortal ()、google ()、mavenCentral ();

  • 使用 Gradle Version Catalog(libs.versions.toml)统一管理所有依赖版本,禁止硬编码。

(2)编译配置

  • 编译版本:compileSdk 34、minSdk 24、targetSdk 34;

  • 编译优化:启用 KSP(替代 KAPT,编译速度提升 20%+)、增量编译、Gradle 缓存;

  • 构建类型:区分 Debug/Release,Debug 版启用调试工具,Release 版混淆 + 资源压缩 + APK 对齐。

(3)多渠道打包

  • 基于 productFlavors 实现华为 / 小米 / 应用宝 / OPPO/VIVO/ 通用渠道打包;

  • 渠道信息注入 BuildConfig 和 AndroidManifest,支持渠道专属配置(APP 名称、API 密钥、服务器地址);

  • 提供批量打包脚本,APK 命名规范:应用名_版本_渠道_时间.apk。

3.3 技术选型明细

表格

模块

技术选型

核心要求

日志

Timber

Debug/Release 区分日志级别,Release 版禁用敏感日志

网络

Retrofit+OkHttp

配置超时时间、日志拦截器,Debug 版集成 Chucker 可视化调试

JSON 序列化

Gson

避免与 Retrofit 转换器冲突,敏感字段序列化前加密

数据库

Room(KSP)

支持 Flow 查询、事务、版本迁移、索引、敏感字段加密,导出 Schema

UI

Material3(View/Compose)

禁用 Compose 默认,可配置切换,View 体系启用 ViewBinding

调试监控

LeakCanary+Crashlytics

仅 Debug 版集成 LeakCanary,全版本集成 Crashlytics 崩溃捕获

敏感信息加密

AES-256/GCM+AndroidKeyStore

密钥存储在 KeyStore,禁止硬编码,Root 设备禁止解密,敏感数据用 CharArray 存储

生命周期

Lifecycle+ViewModel+LiveData

遵循 MVVM 生命周期规范,避免内存泄漏

3.4 安全规范

  • 敏感信息加密:API 密钥、用户令牌、手机号等敏感数据采用 AES-256/GCM 加密,密钥存储在 AndroidKeyStore;

  • Root 检测:Root 设备禁止执行敏感操作(加密 / 解密 / 网络请求);

  • 混淆规则:完善 Room/Retrofit/LeakCanary 等库的混淆规则,Release 版必须开启混淆和资源压缩;

  • 网络安全:禁用明文流量,配置 HTTPS,敏感请求头(如 Token)脱敏。

3.5 调试与性能

  • 内存泄漏:Debug 版集成 LeakCanary,自动检测 Activity/ViewModel 泄漏;

  • 网络调试:Debug 版集成 Chucker,可视化查看网络请求 / 响应,脱敏敏感字段;

  • 编译性能:启用 Gradle 缓存、并行构建、增量编译,禁用未使用的构建特性(AIDL/RenderScript);

  • 数据库性能:Room 添加索引、增量编译,批量操作优于循环单条操作。

四、输出要求

4.1 工程文件清单

  1. 根目录:settings.gradle.kts(仓库配置)、gradle/libs.versions.toml(Version Catalog)、build_channels.sh(批量打包脚本);

  2. App 模块:build.gradle.kts(完整配置)、proguard-rules.pro(混淆规则);

  3. 核心代码:

    • 加密模块:EncryptManager.kt(AES 加密)、RootDetector.kt(Root 检测);

    • 数据库模块:AppDatabase.kt(Room 进阶)、UserEntity.kt(实体)、UserDao.kt(DAO)、UserRepository.kt(仓库);

    • 网络模块:RetrofitManager.kt(含 Chucker)、ApiService.kt;

    • UI 模块:View 体系(Activity+XML)/Compose 体系(Activity)示例、ViewModel 示例;

    • 应用入口:App.kt(Application,初始化 LeakCanary / 数据库 / 仓库);

  4. 配置说明:所有文件添加清晰注释,标注对应「谷歌最佳实践 / 阿里规范」。

4.2 代码规范

  • 命名规范:遵循阿里 Kotlin 命名规范(类名大驼峰、方法名小驼峰、常量全大写);

  • 注释规范:核心类 / 方法添加文档注释,说明用途、参数、返回值,标注规范依据;

  • 错误处理:所有异步操作添加 try-catch,网络 / 数据库异常统一处理,Crashlytics 捕获崩溃;

  • 内存优化:避免静态 Context、匿名内部类泄漏,敏感数据使用 CharArray 存储后清空。

4.3 兼容性要求

  • 版本兼容:AGP 8.2.0 + Gradle 8.5 + Kotlin 1.9.0 + KSP 1.9.0-1.0.13;

  • 系统兼容:minSdk 24(Android 7.0),适配主流国产手机(华为 / 小米 / OPPO/VIVO);

  • 依赖兼容:Room 2.6.1 兼容 Coroutine 1.7.3,Retrofit 2.9.0 兼容 OkHttp 4.11.0。

五、分模块细化提示词(按需拆分使用)

5.1 模块 1:工程基础配置

plaintext

角色:资深Android架构师
任务:输出Android项目基础配置文件,要求:
1. settings.gradle.kts:移除jcenter,添加阿里Maven镜像+jitpack.io;
2. gradle/libs.versions.toml:按[versions/libraries/plugins/defaults]分类管理依赖,包含KSP/Compose/加密/调试工具版本;
3. app/build.gradle.kts:配置MVVM基础依赖、KSP、BuildType、多渠道Flavor;
4. 所有配置标注对应谷歌/阿里规范,注释清晰。
输出:完整的3个配置文件,可直接复制使用。

5.2 模块 2:敏感信息加密

plaintext

角色:Android安全架构师
任务:输出敏感信息加密工具类,要求:
1. 算法:AES-256/GCM(禁止ECB),密钥存储在AndroidKeyStore;
2. 功能:加密/解密、Root检测、EncryptedSharedPreferences封装;
3. 规范:敏感数据用CharArray存储,解密后清空数组,Root设备禁止操作;
4. 兼容:适配多渠道,不同渠道使用不同密钥别名。
输出:EncryptManager.kt + RootDetector.kt,含完整注释和使用示例。

5.3 模块 3:Room 数据库进阶

plaintext

角色:Android资深工程师
任务:输出Room数据库全套代码,要求:
1. 实体类:添加索引,敏感字段加密存储,符合阿里规范;
2. DAO层:返回Flow,支持批量操作、事务,谷歌最佳实践;
3. 数据库类:单例模式,支持版本迁移,Debug版开启查询日志;
4. Repository层:封装Room操作,解耦UI与数据库,适配MVVM。
输出:UserEntity.kt + UserDao.kt + AppDatabase.kt + UserRepository.kt。

5.4 模块 4:多渠道打包 + 调试工具

plaintext

角色:Android工程专家
任务:输出多渠道打包和调试工具配置,要求:
1. 多渠道:productFlavors配置华为/小米/应用宝等渠道,注入渠道信息;
2. 打包脚本:build_channels.sh,一键生成所有渠道Release包;
3. 调试工具:Debug版集成LeakCanary+Chucker,Release版自动剔除;
4. 崩溃捕获:集成Crashlytics,全版本捕获崩溃日志。
输出:app/build.gradle.kts(渠道配置) + build_channels.sh + RetrofitManager.kt(Chucker) + App.kt(LeakCanary初始化)。

5.5 模块 5:UI 体系切换

plaintext

角色:Android UI工程师
任务:输出View/Compose体系切换的完整代码,要求:
1. 配置:通过Version Catalog的useCompose开关一键切换;
2. View体系:Activity+XML+ViewBinding,监听Flow更新UI;
3. Compose体系:Activity+Compose,collectAsStateWithLifecycle监听数据;
4. ViewModel:完全复用,无UI耦合,符合MVVM规范。
输出:View体系(Activity+XML) + Compose体系(Activity) + 通用ViewModel。

六、注意事项

  1. 版本兼容:KSP 版本需与 Kotlin 版本严格匹配(如 Kotlin 1.9.0 → KSP 1.9.0-1.0.13);

  2. 规范对齐:所有配置需标注「谷歌最佳实践」/「阿里开发规范」依据;

  3. 敏感信息:加密密钥需在 CI/CD 中生成,禁止明文出现在代码中;

  4. 调试工具:仅 Debug 版集成,Release 版必须使用 no-op 包或剔除,避免体积膨胀。

七、使用说明

  1. 完整使用:直接复制「三、项目核心需求」+「四、输出要求」到 AI 工具,生成全套工程代码;

  2. 拆分使用:复制「五、分模块细化提示词」中对应模块,生成指定功能代码;

  3. 定制调整:修改 Version Catalog 中的useCompose/enableEncrypt等开关,适配个性化需求。

其它:

  • 其它全局异常处理

  • 可选项:360加固

  • 可选项:walle渠道

那年今日11 月 17 日

    评论区