2026/9/16 7:48:26
FEATURED · 精选文章 
简介本资源是一套面向Android开发初学者的Android Studio实战入门实例聚焦IDE基础配置、UI界面设计、Java逻辑编写与Gradle构建全流程帮助零基础学习者快速建立Android应用开发的完整认知框架。压缩包共496个文件包含81个XML布局文件用于定义Activity界面结构、5个Java源码文件含主Activity及事件处理逻辑、3个gradle构建脚本管理依赖与编译配置、121个JSON与127个flat资源文件多为AS自动生成的编译中间产物与资源索引以及APK安装包、调试日志配置等配套文件整体大小13.91MB结构完整、开箱即用。已有2951人学习下载资源涵盖从项目创建、SDK版本选择、包名设置到ConstraintLayout界面搭建、Button点击响应、Intent页面跳转等核心操作所有代码与配置均经实机验证可直接导入Android Studio运行调试是夯实Android开发基本功的高实用性参考范例。1. 别再从“Hello World”开始新建项目Android Studio 实例程序是快速上手的真实切口很多刚装好 Android Studio 的开发者点开欢迎界面后第一反应是「New Project」——然后卡在 Activity 类型、最低 SDK 版本、是否包含 C 支持这些选项里。其实官方早已内置了一套可直接运行、带完整 UI 逻辑和调试入口的实例程序Sample Projects它们不是教学 Demo而是真实 App 的最小可行切片有网络请求、有 RecyclerView 分页、有 Jetpack Compose 动画、有 Room 数据库迁移路径甚至包含 Material 3 主题适配和无障碍支持检查点。这些实例不依赖外部文档就能编译运行且全部基于当前稳定版 AGPAndroid Gradle Plugin和 Kotlin DSL 配置。对新手它是比官方文档更直观的“可执行说明书”对老手它是验证新环境是否配置正确的黄金标准——比如android studio importing gradle project 太慢或android studio build 出现tag number over 30 is not supported这类报错用实例程序一跑就定位是 Gradle 插件版本不匹配还是 JDK 路径错误。本文聚焦如何精准调用、修改、复用这些实例程序覆盖从首次启动到深度定制的全链路。2. 从欢迎界面直达实例程序三种可靠入口与初始化关键参数Android Studio 内置的实例程序并非隐藏功能而是通过三个明确入口提供欢迎界面的「Sample Projects」标签页、新建项目向导中的「Import an Android code sample」选项、以及菜单栏的「File → New → Import Sample…」。三者底层调用同一套 Google 官方 Samples 仓库android/samples但行为细节不同需按场景选择。2.1 欢迎界面「Sample Projects」适合首次验证环境完整性这是最推荐的起点。启动 Android Studio 后不打开任何项目直接进入欢迎界面在左侧导航栏点击「Sample Projects」。此时界面会加载一个分类列表UI Components、Architecture Components、Kotlin Coroutines、Jetpack Compose等。注意该列表内容取决于本地已安装的 Android SDK Samples for Android API 版本。若列表为空或显示“Loading…”超时说明 SDK Manager 中未安装 Samples 组件。此时需手动补全# 在终端中执行macOS/Linux或命令提示符Windows # 先确认 SDK 路径Android Studio → Preferences → Appearance Behavior → System Settings → Android SDK → SDK Location # 假设 SDK 路径为 /Users/username/Library/Android/sdk sdkmanager samples;android-34提示samples;android-34中的34对应 Android 14API 34。若你使用的是较旧版本 Android Studio如 Giraffe请改用samples;android-33。执行后需等待下载完成期间 Android Studio 可能无响应属正常现象。完成后重启 IDE欢迎界面即可显示实例列表。2.2 「Import an Android code sample」适用于需要指定 API 级别或离线开发当欢迎界面因网络问题无法加载或你需要强制使用特定 API 版本的实例例如测试 Android 13 的新权限模型此入口更可控。操作路径欢迎界面 →「New Project」→ 左侧模板列表滚动到底部 → 选择「Import an Android code sample」→ 点击右下角「Next」。此时会弹出一个树状结构对话框根节点为Android Samples展开后可见按 API 级别分组的文件夹如android-34、android-33。关键动作是先勾选目标 API 文件夹再在其子项中选择具体实例。例如要运行带 ViewModel 和 LiveData 的架构示例应展开android-34→architecture→ViewModel→ 勾选ViewModelSample。此时右侧预览区会显示该项目的简要描述、所需最低 SDK、是否含 Kotlin 代码等元信息。注意此方式导入时Android Studio 会自动检测并提示缺失的 SDK Platform 和 Build-Tools。若提示android studio sdk无法勾选的解决方法类错误通常是因为 SDK Manager 中对应 Platform 未安装。此时需手动打开 SDK ManagerConfigure → SDK Manager在「SDK Platforms」标签页勾选对应 API Level如 Android 14并在「SDK Tools」中确保「Android SDK Build-Tools」最新版已安装。2.3 「File → New → Import Sample…」用于已有项目中嵌入实例模块此入口适用于在现有工程中复用某个功能模块。例如你的 App 需要实现环形图android studio 实现自定义view环形图不必重写可直接将ui-widgets下的CircularProgressIndicator示例作为 Module 导入。操作路径已打开项目 → 菜单栏 File → New → Import Sample… → 在弹出窗口中搜索关键词circular→ 选择CircularProgressIndicator→ 点击「Next」→ 在「Import Options」中设置 Module Name如circular-widget和 Destination Folder建议放在项目根目录下samples/子目录中。导入后IDE 会自动在settings.gradle中添加include :circular-widget并在主模块的build.gradle中添加implementation project(:circular-widget)依赖。3. 编译与运行实例程序Gradle 配置、模拟器连接与常见构建失败修复实例程序虽经 Google 官方测试但在本地运行仍可能因环境差异失败。核心问题集中在 Gradle 配置、JDK 版本、模拟器兼容性三方面。以下为可复现的排查路径。3.1 Gradle 与 AGP 版本匹配避免tag number over 30 is not supported报错该错误本质是 Gradle 插件版本过高而项目使用的 Gradle Wrapper 版本过低。实例程序的gradle/wrapper/gradle-wrapper.properties文件中指定了distributionUrl例如# gradle/wrapper/gradle-wrapper.properties distributionUrlhttps\://services.gradle.org/distributions/gradle-8.4-bin.zip而build.gradleProject 级中声明了 AGP 版本// build.gradle (Project) plugins { id com.android.application version 8.3.0 apply false id org.jetbrains.kotlin.android version 1.9.20 apply false }关键规则AGP 8.3.x 要求 Gradle 8.4AGP 8.4.x 要求 Gradle 8.5。若你看到tag number over 30 is not supported大概率是 AGP 版本如 8.4.0与 Gradle 版本如 8.2不匹配。修复方法打开gradle/wrapper/gradle-wrapper.properties将distributionUrl升级至匹配版本例如改为gradle-8.5-bin.zip同时确保build.gradle中 AGP 版本与之对应如8.4.0。修改后Android Studio 会提示「Sync Now」点击同步即可。3.2 JDK 版本校验解决unable to find suitable visual studio toolc类混淆错误该错误常被误认为 Visual Studio 问题实则是 Android Studio 使用了不兼容的 JDK。实例程序默认要求 JDK 17Android Studio Giraffe 及以上版本强制要求。检查路径Android Studio → Preferences → Build, Execution, Deployment → Build Tools → Gradle → Gradle JVM。此处必须指向 JDK 17 或 JDK 21LTS不能是 JDK 8 或 JDK 11。若显示为Embedded JDK则无需修改若为自定义路径请确认该路径下java -version输出为17.x.x或21.x.x。若 JDK 17 未安装可从 Adoptium 下载 Temurin 17并在此处指定其bin目录路径。3.3 模拟器连接与真机调试android studio 如何连接小米手机的通用解法实例程序需运行在设备上。模拟器推荐使用 Android Studio 自带的 Pixel 设备镜像API 34 或 33。创建步骤AVD Manager → Create Virtual Device → 选择 Pixel 5 → Next → 选择Android 14 (API Level 34)系统镜像 → Download → Finish。启动模拟器后若实例程序 Run 按钮灰色说明设备未就绪。此时在终端执行# 确认 adb 是否识别设备 adb devices # 正常输出应为 # List of devices attached # emulator-5554 device若连接小米等真机需开启开发者选项设置 → 我的设备 → 连续点击 MIUI 版本 7 次再开启 USB 调试。连接 USB 后执行adb devices若显示??????????? no permissions则需在终端执行# Linux/macOS重启 adb server 并赋予权限 sudo adb kill-server sudo adb start-server adb devices # Windows以管理员身份运行命令提示符执行相同命令4. 修改与复用实例程序从修改字符串到集成 Room 数据库的四步实践实例程序的价值不在“看”而在“改”。以下以RoomSample位于architecture/room为例演示如何将其从示例升级为可复用的业务模块。4.1 第一步修改包名与应用 ID避免签名冲突实例程序默认包名为com.example.android.architecture.blueprints.roomwordssample。若直接运行会与你其他项目冲突。修改路径app/src/main/AndroidManifest.xml修改packagecom.yourcompany.roomdemoapp/build.gradle修改applicationId com.yourcompany.roomdemo在 Project 视图中右键com.example.android...包名 → Refactor → Rename → 选择「Rename package」→ 输入com.yourcompany.roomdemo→ 确认注意Refactor 后IDE 会自动更新所有 Java/Kotlin 文件中的package声明和import语句。若出现Unresolved reference说明有遗漏需手动检查data、ui等子包下的文件。4.2 第二步替换示例数据为真实业务字段RoomSample中的WordEntity 定义如下// data/Word.kt Entity(tableName word_table) data class Word( PrimaryKey ColumnInfo(name word) val word: String, ColumnInfo(name meaning) val meaning: String )业务中可能需要扩展字段。例如增加createdAt时间戳和isFavorite标志位Entity(tableName word_table) data class Word( PrimaryKey ColumnInfo(name word) val word: String, ColumnInfo(name meaning) val meaning: String, ColumnInfo(name created_at) val createdAt: Long System.currentTimeMillis(), // 新增时间戳 ColumnInfo(name is_favorite) val isFavorite: Boolean false // 新增收藏状态 )关键动作修改 Entity 后必须同步更新WordDao接口添加对应的查询方法如Query(SELECT * FROM word_table WHERE is_favorite 1)并在WordRoomDatabase的databaseBuilder中调用.addMigrations()否则首次运行会因表结构不匹配而崩溃。4.3 第三步集成网络层替换硬编码数据实例程序通常用FakeRepository模拟数据。要接入真实 API需替换WordRepository实现。假设后端提供/api/words接口返回 JSON[ {word: Kotlin, meaning: A modern programming language}, {word: Jetpack, meaning: A suite of libraries for Android development} ]创建 Retrofit Service// data/api/WordApiService.kt interface WordApiService { GET(api/words) suspend fun getWords(): ListWord } // data/repository/NetworkWordRepository.kt class NetworkWordRepository(private val apiService: WordApiService) : WordRepository { override suspend fun getAllWords(): ListWord apiService.getWords() }在Application类中注入// app/src/main/java/com/yourcompany/roomdemo/WordApplication.kt class WordApplication : Application() { lateinit var wordRepository: WordRepository override fun onCreate() { super.onCreate() val retrofit Retrofit.Builder() .baseUrl(https://your-api.com/) .addConverterFactory(GsonConverterFactory.create()) .build() val apiService retrofit.create(WordApiService::class.java) wordRepository NetworkWordRepository(apiService) } }提示此步骤需在AndroidManifest.xml的application标签中添加android:name.WordApplication否则onCreate()不会被调用。4.4 第四步配置 Gradle 镜像源加速依赖下载国内用户常遇android studio importing gradle project 太慢。在项目根目录gradle.properties中添加# gradle.properties systemProp.http.proxyHostmirrors.tuna.tsinghua.edu.cn systemProp.http.proxyPort80 systemProp.https.proxyHostmirrors.tuna.tsinghua.edu.cn systemProp.https.proxyPort443并在build.gradleProject 级的repositories块中将google()和mavenCentral()替换为清华源// build.gradle (Project) dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { maven { url https://maven.aliyun.com/repository/public } maven { url https://maven.aliyun.com/repository/google } maven { url https://maven.aliyun.com/repository/gradle-plugin } // 移除 google() 和 mavenCentral() } }5. 进阶技巧离线使用实例程序、批量导出与 Git 版本管理最佳实践当网络受限或需在多台机器部署统一开发环境时离线化实例程序是刚需。同时将修改后的实例纳入 Git 管理需规避敏感文件和冗余构建产物。5.1 离线缓存实例程序下载 ZIP 包并本地导入Google 官方 Samples 仓库托管在 GitHub可直接下载 ZIP。访问 https://github.com/android/samples 点击「Code」→「Download ZIP」。解压后目录结构为samples/category/sample-name。例如samples/ui-widgets/CircularProgressIndicator。导入路径Android Studio → Welcome → New Project → Import Sample → 点击右下角「Browse」→ 选择解压后的CircularProgressIndicator文件夹 → 完成导入。此方式完全离线且可确保使用与 GitHub 主干一致的代码避免 IDE 内置缓存版本滞后。5.2 Git 忽略清单精简提交体积防止密钥泄露修改实例程序后需git init并提交。但以下目录和文件必须加入.gitignore路径说明忽略原因/.idea/IDE 配置文件含本地路径、窗口布局跨机器不兼容/app/build/构建产物体积大每次编译生成无需版本控制/local.propertiesSDK 路径配置含绝对路径不同机器路径不同/.gradle/Gradle 缓存本地下载的依赖包Git 无法有效 diff标准.gitignore片段# Android Studio .idea/ *.iml .gradle/ local.properties # Build outputs /app/build/ /app/debug/ /app/release/ # Misc .DS_Store5.3 批量导出示例用命令行快速生成多个变体若需为团队准备一套标准化实例模板如room-sample-v1,room-sample-v2可编写 Bash 脚本批量复制并重命名#!/bin/bash # batch-import.sh SAMPLE_DIR/path/to/android/samples/architecture/room TARGET_BASE/Users/username/Projects/android-samples for version in v1 v2 v3; do TARGET_DIR${TARGET_BASE}/room-sample-${version} cp -r $SAMPLE_DIR $TARGET_DIR # 替换包名Linux/macOS sed find $TARGET_DIR -type f -name *.kt -exec sed -i s/com\.example\.android\.architecture\.blueprints\.roomwordssample/com\.yourcompany\.roomsample/g {} find $TARGET_DIR -type f -name AndroidManifest.xml -exec sed -i s/packagecom\.example\.android\.architecture\.blueprints\.roomwordssample/packagecom\.yourcompany\.roomsample/g {} echo Created $TARGET_DIR done运行chmod x batch-import.sh ./batch-import.sh即可在数秒内生成三个独立实例目录每个都已预置业务包名可直接导入 Android Studio。本文还有配套的精品资源点击获取
Android Studio内置实例程序：快速上手与环境验证指南
简介本资源是一套面向Android开发初学者的Android Studio实战入门实例聚焦IDE基础配置、UI界面设计、Java逻辑编写与Gradle构建全流程帮助零基础学习者快速建立Android应用开发的完整认知框架。压缩包共496个文件包含81个XML布局文件用于定义Activity界面结构、5个Java源码文件含主Activity及事件处理逻辑、3个gradle构建脚本管理依赖与编译配置、121个JSON与127个flat资源文件多为AS自动生成的编译中间产物与资源索引以及APK安装包、调试日志配置等配套文件整体大小13.91MB结构完整、开箱即用。已有2951人学习下载资源涵盖从项目创建、SDK版本选择、包名设置到ConstraintLayout界面搭建、Button点击响应、Intent页面跳转等核心操作所有代码与配置均经实机验证可直接导入Android Studio运行调试是夯实Android开发基本功的高实用性参考范例。1. 别再从“Hello World”开始新建项目Android Studio 实例程序是快速上手的真实切口很多刚装好 Android Studio 的开发者点开欢迎界面后第一反应是「New Project」——然后卡在 Activity 类型、最低 SDK 版本、是否包含 C 支持这些选项里。其实官方早已内置了一套可直接运行、带完整 UI 逻辑和调试入口的实例程序Sample Projects它们不是教学 Demo而是真实 App 的最小可行切片有网络请求、有 RecyclerView 分页、有 Jetpack Compose 动画、有 Room 数据库迁移路径甚至包含 Material 3 主题适配和无障碍支持检查点。这些实例不依赖外部文档就能编译运行且全部基于当前稳定版 AGPAndroid Gradle Plugin和 Kotlin DSL 配置。对新手它是比官方文档更直观的“可执行说明书”对老手它是验证新环境是否配置正确的黄金标准——比如android studio importing gradle project 太慢或android studio build 出现tag number over 30 is not supported这类报错用实例程序一跑就定位是 Gradle 插件版本不匹配还是 JDK 路径错误。本文聚焦如何精准调用、修改、复用这些实例程序覆盖从首次启动到深度定制的全链路。2. 从欢迎界面直达实例程序三种可靠入口与初始化关键参数Android Studio 内置的实例程序并非隐藏功能而是通过三个明确入口提供欢迎界面的「Sample Projects」标签页、新建项目向导中的「Import an Android code sample」选项、以及菜单栏的「File → New → Import Sample…」。三者底层调用同一套 Google 官方 Samples 仓库android/samples但行为细节不同需按场景选择。2.1 欢迎界面「Sample Projects」适合首次验证环境完整性这是最推荐的起点。启动 Android Studio 后不打开任何项目直接进入欢迎界面在左侧导航栏点击「Sample Projects」。此时界面会加载一个分类列表UI Components、Architecture Components、Kotlin Coroutines、Jetpack Compose等。注意该列表内容取决于本地已安装的 Android SDK Samples for Android API 版本。若列表为空或显示“Loading…”超时说明 SDK Manager 中未安装 Samples 组件。此时需手动补全# 在终端中执行macOS/Linux或命令提示符Windows # 先确认 SDK 路径Android Studio → Preferences → Appearance Behavior → System Settings → Android SDK → SDK Location # 假设 SDK 路径为 /Users/username/Library/Android/sdk sdkmanager samples;android-34提示samples;android-34中的34对应 Android 14API 34。若你使用的是较旧版本 Android Studio如 Giraffe请改用samples;android-33。执行后需等待下载完成期间 Android Studio 可能无响应属正常现象。完成后重启 IDE欢迎界面即可显示实例列表。2.2 「Import an Android code sample」适用于需要指定 API 级别或离线开发当欢迎界面因网络问题无法加载或你需要强制使用特定 API 版本的实例例如测试 Android 13 的新权限模型此入口更可控。操作路径欢迎界面 →「New Project」→ 左侧模板列表滚动到底部 → 选择「Import an Android code sample」→ 点击右下角「Next」。此时会弹出一个树状结构对话框根节点为Android Samples展开后可见按 API 级别分组的文件夹如android-34、android-33。关键动作是先勾选目标 API 文件夹再在其子项中选择具体实例。例如要运行带 ViewModel 和 LiveData 的架构示例应展开android-34→architecture→ViewModel→ 勾选ViewModelSample。此时右侧预览区会显示该项目的简要描述、所需最低 SDK、是否含 Kotlin 代码等元信息。注意此方式导入时Android Studio 会自动检测并提示缺失的 SDK Platform 和 Build-Tools。若提示android studio sdk无法勾选的解决方法类错误通常是因为 SDK Manager 中对应 Platform 未安装。此时需手动打开 SDK ManagerConfigure → SDK Manager在「SDK Platforms」标签页勾选对应 API Level如 Android 14并在「SDK Tools」中确保「Android SDK Build-Tools」最新版已安装。2.3 「File → New → Import Sample…」用于已有项目中嵌入实例模块此入口适用于在现有工程中复用某个功能模块。例如你的 App 需要实现环形图android studio 实现自定义view环形图不必重写可直接将ui-widgets下的CircularProgressIndicator示例作为 Module 导入。操作路径已打开项目 → 菜单栏 File → New → Import Sample… → 在弹出窗口中搜索关键词circular→ 选择CircularProgressIndicator→ 点击「Next」→ 在「Import Options」中设置 Module Name如circular-widget和 Destination Folder建议放在项目根目录下samples/子目录中。导入后IDE 会自动在settings.gradle中添加include :circular-widget并在主模块的build.gradle中添加implementation project(:circular-widget)依赖。3. 编译与运行实例程序Gradle 配置、模拟器连接与常见构建失败修复实例程序虽经 Google 官方测试但在本地运行仍可能因环境差异失败。核心问题集中在 Gradle 配置、JDK 版本、模拟器兼容性三方面。以下为可复现的排查路径。3.1 Gradle 与 AGP 版本匹配避免tag number over 30 is not supported报错该错误本质是 Gradle 插件版本过高而项目使用的 Gradle Wrapper 版本过低。实例程序的gradle/wrapper/gradle-wrapper.properties文件中指定了distributionUrl例如# gradle/wrapper/gradle-wrapper.properties distributionUrlhttps\://services.gradle.org/distributions/gradle-8.4-bin.zip而build.gradleProject 级中声明了 AGP 版本// build.gradle (Project) plugins { id com.android.application version 8.3.0 apply false id org.jetbrains.kotlin.android version 1.9.20 apply false }关键规则AGP 8.3.x 要求 Gradle 8.4AGP 8.4.x 要求 Gradle 8.5。若你看到tag number over 30 is not supported大概率是 AGP 版本如 8.4.0与 Gradle 版本如 8.2不匹配。修复方法打开gradle/wrapper/gradle-wrapper.properties将distributionUrl升级至匹配版本例如改为gradle-8.5-bin.zip同时确保build.gradle中 AGP 版本与之对应如8.4.0。修改后Android Studio 会提示「Sync Now」点击同步即可。3.2 JDK 版本校验解决unable to find suitable visual studio toolc类混淆错误该错误常被误认为 Visual Studio 问题实则是 Android Studio 使用了不兼容的 JDK。实例程序默认要求 JDK 17Android Studio Giraffe 及以上版本强制要求。检查路径Android Studio → Preferences → Build, Execution, Deployment → Build Tools → Gradle → Gradle JVM。此处必须指向 JDK 17 或 JDK 21LTS不能是 JDK 8 或 JDK 11。若显示为Embedded JDK则无需修改若为自定义路径请确认该路径下java -version输出为17.x.x或21.x.x。若 JDK 17 未安装可从 Adoptium 下载 Temurin 17并在此处指定其bin目录路径。3.3 模拟器连接与真机调试android studio 如何连接小米手机的通用解法实例程序需运行在设备上。模拟器推荐使用 Android Studio 自带的 Pixel 设备镜像API 34 或 33。创建步骤AVD Manager → Create Virtual Device → 选择 Pixel 5 → Next → 选择Android 14 (API Level 34)系统镜像 → Download → Finish。启动模拟器后若实例程序 Run 按钮灰色说明设备未就绪。此时在终端执行# 确认 adb 是否识别设备 adb devices # 正常输出应为 # List of devices attached # emulator-5554 device若连接小米等真机需开启开发者选项设置 → 我的设备 → 连续点击 MIUI 版本 7 次再开启 USB 调试。连接 USB 后执行adb devices若显示??????????? no permissions则需在终端执行# Linux/macOS重启 adb server 并赋予权限 sudo adb kill-server sudo adb start-server adb devices # Windows以管理员身份运行命令提示符执行相同命令4. 修改与复用实例程序从修改字符串到集成 Room 数据库的四步实践实例程序的价值不在“看”而在“改”。以下以RoomSample位于architecture/room为例演示如何将其从示例升级为可复用的业务模块。4.1 第一步修改包名与应用 ID避免签名冲突实例程序默认包名为com.example.android.architecture.blueprints.roomwordssample。若直接运行会与你其他项目冲突。修改路径app/src/main/AndroidManifest.xml修改packagecom.yourcompany.roomdemoapp/build.gradle修改applicationId com.yourcompany.roomdemo在 Project 视图中右键com.example.android...包名 → Refactor → Rename → 选择「Rename package」→ 输入com.yourcompany.roomdemo→ 确认注意Refactor 后IDE 会自动更新所有 Java/Kotlin 文件中的package声明和import语句。若出现Unresolved reference说明有遗漏需手动检查data、ui等子包下的文件。4.2 第二步替换示例数据为真实业务字段RoomSample中的WordEntity 定义如下// data/Word.kt Entity(tableName word_table) data class Word( PrimaryKey ColumnInfo(name word) val word: String, ColumnInfo(name meaning) val meaning: String )业务中可能需要扩展字段。例如增加createdAt时间戳和isFavorite标志位Entity(tableName word_table) data class Word( PrimaryKey ColumnInfo(name word) val word: String, ColumnInfo(name meaning) val meaning: String, ColumnInfo(name created_at) val createdAt: Long System.currentTimeMillis(), // 新增时间戳 ColumnInfo(name is_favorite) val isFavorite: Boolean false // 新增收藏状态 )关键动作修改 Entity 后必须同步更新WordDao接口添加对应的查询方法如Query(SELECT * FROM word_table WHERE is_favorite 1)并在WordRoomDatabase的databaseBuilder中调用.addMigrations()否则首次运行会因表结构不匹配而崩溃。4.3 第三步集成网络层替换硬编码数据实例程序通常用FakeRepository模拟数据。要接入真实 API需替换WordRepository实现。假设后端提供/api/words接口返回 JSON[ {word: Kotlin, meaning: A modern programming language}, {word: Jetpack, meaning: A suite of libraries for Android development} ]创建 Retrofit Service// data/api/WordApiService.kt interface WordApiService { GET(api/words) suspend fun getWords(): ListWord } // data/repository/NetworkWordRepository.kt class NetworkWordRepository(private val apiService: WordApiService) : WordRepository { override suspend fun getAllWords(): ListWord apiService.getWords() }在Application类中注入// app/src/main/java/com/yourcompany/roomdemo/WordApplication.kt class WordApplication : Application() { lateinit var wordRepository: WordRepository override fun onCreate() { super.onCreate() val retrofit Retrofit.Builder() .baseUrl(https://your-api.com/) .addConverterFactory(GsonConverterFactory.create()) .build() val apiService retrofit.create(WordApiService::class.java) wordRepository NetworkWordRepository(apiService) } }提示此步骤需在AndroidManifest.xml的application标签中添加android:name.WordApplication否则onCreate()不会被调用。4.4 第四步配置 Gradle 镜像源加速依赖下载国内用户常遇android studio importing gradle project 太慢。在项目根目录gradle.properties中添加# gradle.properties systemProp.http.proxyHostmirrors.tuna.tsinghua.edu.cn systemProp.http.proxyPort80 systemProp.https.proxyHostmirrors.tuna.tsinghua.edu.cn systemProp.https.proxyPort443并在build.gradleProject 级的repositories块中将google()和mavenCentral()替换为清华源// build.gradle (Project) dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { maven { url https://maven.aliyun.com/repository/public } maven { url https://maven.aliyun.com/repository/google } maven { url https://maven.aliyun.com/repository/gradle-plugin } // 移除 google() 和 mavenCentral() } }5. 进阶技巧离线使用实例程序、批量导出与 Git 版本管理最佳实践当网络受限或需在多台机器部署统一开发环境时离线化实例程序是刚需。同时将修改后的实例纳入 Git 管理需规避敏感文件和冗余构建产物。5.1 离线缓存实例程序下载 ZIP 包并本地导入Google 官方 Samples 仓库托管在 GitHub可直接下载 ZIP。访问 https://github.com/android/samples 点击「Code」→「Download ZIP」。解压后目录结构为samples/category/sample-name。例如samples/ui-widgets/CircularProgressIndicator。导入路径Android Studio → Welcome → New Project → Import Sample → 点击右下角「Browse」→ 选择解压后的CircularProgressIndicator文件夹 → 完成导入。此方式完全离线且可确保使用与 GitHub 主干一致的代码避免 IDE 内置缓存版本滞后。5.2 Git 忽略清单精简提交体积防止密钥泄露修改实例程序后需git init并提交。但以下目录和文件必须加入.gitignore路径说明忽略原因/.idea/IDE 配置文件含本地路径、窗口布局跨机器不兼容/app/build/构建产物体积大每次编译生成无需版本控制/local.propertiesSDK 路径配置含绝对路径不同机器路径不同/.gradle/Gradle 缓存本地下载的依赖包Git 无法有效 diff标准.gitignore片段# Android Studio .idea/ *.iml .gradle/ local.properties # Build outputs /app/build/ /app/debug/ /app/release/ # Misc .DS_Store5.3 批量导出示例用命令行快速生成多个变体若需为团队准备一套标准化实例模板如room-sample-v1,room-sample-v2可编写 Bash 脚本批量复制并重命名#!/bin/bash # batch-import.sh SAMPLE_DIR/path/to/android/samples/architecture/room TARGET_BASE/Users/username/Projects/android-samples for version in v1 v2 v3; do TARGET_DIR${TARGET_BASE}/room-sample-${version} cp -r $SAMPLE_DIR $TARGET_DIR # 替换包名Linux/macOS sed find $TARGET_DIR -type f -name *.kt -exec sed -i s/com\.example\.android\.architecture\.blueprints\.roomwordssample/com\.yourcompany\.roomsample/g {} find $TARGET_DIR -type f -name AndroidManifest.xml -exec sed -i s/packagecom\.example\.android\.architecture\.blueprints\.roomwordssample/packagecom\.yourcompany\.roomsample/g {} echo Created $TARGET_DIR done运行chmod x batch-import.sh ./batch-import.sh即可在数秒内生成三个独立实例目录每个都已预置业务包名可直接导入 Android Studio。本文还有配套的精品资源点击获取 
