简介本资源是一份面向计算机及相关专业本科生的移动开发期末大作业实战项目——高分备忘录App专为课程设计、实训练习与毕业设计前期实践打造。项目经导师指导并获98分高分评价源码全部本地编译通过、严格调试可直接运行配套导入文档详述Android Studio环境配置与常见问题解决方法并附多张核心界面截图辅助理解。压缩包共67个文件含10个Java业务逻辑文件、22个XML布局与资源定义文件、10个WebP图标资源、3个Gradle构建脚本及1个可安装APK整体4.07MB结构规范、模块清晰涵盖数据持久化、RecyclerView列表管理、增删改查交互等典型Android开发要点。目前已有148人学习下载适合移动开发初学者巩固四大组件、UI适配与MVC基础架构亦可作为课程答辩演示或二次开发原型参考。1. 这不是“交作业”而是一次完整的移动开发实战复盘备忘录App听起来像教科书里最基础的练手项目——但如果你真把它当成“随便写写就能交差”的期末作业那大概率会卡在 gradle.properties 配置失败、FileProvider 路径报错、Android 12 通知权限崩溃、甚至截图时发现界面元素错位这些细节上。我带过三届移动开发实训课每年都有学生拿着“功能全对、UI 漂亮、文档齐全”的备忘录 App 却只拿 75 分原因全出在那些不写进教材、但真实开发中天天打交道的“隐性工程规范”上。这次要拆解的就是一个能稳拿 95 的高分备忘录 App 全流程它不只是增删改查而是把 Android Studio 4.2 环境下从项目初始化、依赖管理、权限适配、文件存储路径迁移、到最终 APK 打包签名的完整链路全部摊开讲透。核心关键词Android、build.gradle、gradle.properties不是配置文件名而是你和系统对话的语法content://com.baidu.searchbox.fileprovider/baiddpath/这类 URI 不是乱码而是 Android 10 存储沙盒机制下你必须亲手写死的契约地址。适合两类人一是正在赶期末 deadline 的同学需要可直接复用的结构化方案二是刚入职的 junior 开发想补上学校没教但公司每天都在用的工程化细节。下面所有步骤我都用自己去年带学生做的真实项目截图已脱敏和 logcat 报错现场还原不讲理论只讲“为什么这行代码必须这么写”。1.1 高分作业的底层逻辑它本质是“Android 工程规范考试”很多同学以为高分 功能多 UI 好看 文档厚。错。真正的高分作业本质是一份Android 工程规范执行报告。它考核的不是你会不会写onCreate()而是你是否理解为什么build.gradle中minSdkVersion必须设为 21 而不是 16—— 因为androidx.appcompat:appcompat1.6.1 版本已弃用 API 16 支持强行设置会导致MaterialToolbar渲染失败而你的截图里如果 toolbar 是空白的老师一眼就扣分为什么gradle.properties里必须加android.useAndroidXtrue和android.enableJetifiertrue—— 这不是可选项是 Android Studio 4.0 的强制开关漏掉它你引用的RecyclerView会编译通过但运行时NoClassDefFoundError而错误日志藏在Logcat里不抓日志根本找不到为什么截图必须包含adb shell dumpsys activity activities | grep mResumedActivity的输出—— 这行命令证明你的 Activity 生命周期管理正确不是靠finish()硬退而是用onPause()保存状态这是 Android 开发的“呼吸感”体现。所以这个备忘录 App 的骨架不是按“添加笔记→编辑→删除”功能模块切分而是按Android 系统层约束 → 开发工具链规范 → 用户交互契约三层递进。接下来每一部分我都会先告诉你“系统在背后要求什么”再告诉你“你该在代码里怎么回应”。1.2 为什么选备忘录而不是天气或计算器—— 它是最小完备的 Android 生态缩影备忘录 App 看似简单实则是 Android 开发的“麻雀虽小五脏俱全”典型存储层既要处理轻量级的 SharedPreferences存用户偏好又要处理结构化数据的 Room 数据库存笔记内容还得兼容外部存储导出 PDF 时写入android/data/com.yourpackage/files/UI 层涉及CoordinatorLayoutAppBarLayout实现折叠标题栏对应热词“android中协调布局banner”RecyclerView带ItemTouchHelper实现滑动删除MaterialButtonToggleGroup控制笔记分类标签系统交互层FileProvider生成content://URI 供第三方 App如微信、钉钉读取导出的文件这就是content://com.baidu.searchbox.fileprovider/...的真实来源NotificationCompat.Builder在 Android 12 上必须指定setSmallIcon()否则崩溃ActivityResultLauncher替代startActivityForResult()处理拍照附件构建层build.gradle中signingConfigs配置 debug 和 release 签名gradle.properties控制org.gradle.jvmargs避免编译内存溢出。它不追求炫技但每一步都踩在 Android 官方文档的“最佳实践”红线上。你做完这个等于把 Android 开发的“地基”夯得结结实实。下面进入正题——不是从MainActivity.java开始而是从gradle.properties这个被 90% 同学忽略的配置文件开始。2. 核心细节解析与实操要点从 gradle.properties 到 FileProvider 的生死线2.1 gradle.properties不是“可有可无的配置文件”而是构建系统的呼吸阀gradle.properties位于项目根目录它不参与编译却决定整个构建过程的成败。很多同学复制网上的模板直接粘贴一堆#注释掉的配置结果编译卡在 99%。真实情况是它只有 4 行关键配置缺一不可。第一行org.gradle.jvmargs-Xmx2048m -XX:MaxMetaspaceSize512m这是给 Gradle Daemon 分配的 JVM 内存。Android Studio 默认分配 1024m但当你引入androidx.compose.ui:ui或kotlinx-coroutines-android后编译时会触发大量 Kotlin 字节码生成内存不足直接 OOM。我实测过-Xmx2048m是底线低于此值./gradlew build会在:app:compileDebugKotlin阶段静默失败logcat 里只有一行Daemon disappeared。这不是 bug是 Gradle 的优雅降级——它宁愿退出也不给你一个错误提示。第二行android.useAndroidXtrue这是 AndroidX 迁移的总开关。2023 年后所有新项目默认开启但如果你从旧项目升级漏掉这一行import androidx.appcompat.app.AppCompatActivity;会编译通过但运行时AppCompatActivity的onCreate()里调用getDelegate()会抛NoSuchMethodError。因为android.support.v7.app.AppCompatActivity的字节码已被移除而androidx的实现类名变了Gradle 不知道该桥接到哪个版本。第三行android.enableJetifiertrue这是 Jetifier 工具的开关。它的作用是把你项目里引用的第三方库比如com.github.bumptech.glide:glide:4.14.2中的android.support.*包名自动重写成androidx.*。没有它Glide 的RequestOptions就无法注入AppCompatActivity的supportFragmentManager。注意Jetifier 只在构建时生效不增加运行时开销但它必须和android.useAndroidXtrue成对出现否则 Jetifier 不启动。第四行kotlin.code.styleofficial这是 Kotlin 编码风格开关。虽然不影响功能但高分作业要求代码格式统一。开启后Android Studio 的Code → Reformat Code会按 Kotlin 官方规范缩进、空格、换行。比如if (condition) {必须换行写{而不是if (condition){。老师用git diff查看提交记录时格式错误会直接扣分。提示gradle.properties文件必须用 UTF-8 编码且不能有 BOM 头。Windows 记事本保存时默认加 BOM会导致 Gradle 解析失败报错Could not compile settings file settings.gradle。解决方案用 VS Code 或 Notepad 保存为 “UTF-8 无 BOM”。2.2 build.gradle不是“写完就能跑”而是 Android 构建生命周期的契约书app/build.gradle是整个项目的“宪法”它定义了从源码编译、资源处理、打包签名的全流程。高分作业的build.gradle必须包含 5 个不可省略的区块少一个截图里就会暴露问题。第一区块android闭包里的compileSdk和targetSdkandroid { compileSdk 34 defaultConfig { applicationId com.example.memo minSdk 21 targetSdk 34 versionCode 1 versionName 1.0 } }compileSdk 34对应 Android 14它决定了你能使用哪些 API。比如NotificationChannel的setSound(null, null)方法在 API 33 才支持如果你设compileSdk 33即使targetSdk 34也无法调用。targetSdk 34是硬性要求——Android 14 强制要求PendingIntent必须显式声明FLAG_IMMUTABLE或FLAG_MUTABLE否则应用启动时崩溃。minSdk 21是底线因为androidx.core:core-ktx1.12.0 已弃用 API 16而MaterialTheme在 API 21 才完整支持。第二区块dependencies里的implementation版本锁定dependencies { implementation androidx.core:core-ktx:1.12.0 implementation androidx.appcompat:appcompat:1.6.1 implementation com.google.android.material:material:1.10.0 implementation androidx.constraintlayout:constraintlayout:2.1.4 // Room 数据库 implementation androidx.room:room-runtime:2.6.1 implementation androidx.room:room-ktx:2.6.1 kapt androidx.room:room-compiler:2.6.1 }所有版本号必须精确到小数点后一位。网上教程常写1.12.这是大忌。会拉取最新版而core-ktx:1.12.1可能引入requireNotNull()的非空断言变更导致你写的val text editText.text.toString()在空输入时崩溃。高分作业要求“可重现”所以必须锁死版本。Room 的kapt插件必须和room-runtime版本一致否则Entity注解不生成 DAO 类编译通过但运行时报ClassNotFoundException。第三区块buildTypes里的debug签名配置android { buildTypes { debug { signingConfig signingConfigs.debug } release { signingConfig signingConfigs.release minifyEnabled true proguardFiles getDefaultProguardFile(proguard-android-optimize.txt), proguard-rules.pro } } signingConfigs { debug { storeFile file(debug.keystore) storePassword android keyAlias androiddebugkey keyPassword android } release { storeFile file(release.keystore) storePassword System.getenv(KEYSTORE_PASSWORD) ?: changeit keyAlias System.getenv(KEY_ALIAS) ?: key0 keyPassword System.getenv(KEY_PASSWORD) ?: changeit } } }debug签名必须用 Android Studio 自动生成的debug.keystore路径在~/.android/debug.keystore。如果你手动创建SHA1 指纹不匹配FileProvider的content://URI 会被系统拒绝。release签名用环境变量读取密码是为了防止 keystore 密码硬编码在代码里——这是安全红线老师会用grep -r android app/src/main/检查。第四区块packagingOptions防止重复类冲突android { packagingOptions { exclude META-INF/DEPENDENCIES exclude META-INF/LICENSE exclude META-INF/license.txt exclude META-INF/license exclude META-INF/license.rtf exclude META-INF/license.txt exclude META-INF/LGPL2.1 exclude META-INF/NOTICE exclude META-INF/notice.txt exclude META-INF/NOTICE.txt exclude META-INF/notice exclude META-INF/ASL2.0 exclude META-INF/MANIFEST.MF } }这是解决Duplicate class android.support.v4.app.Fragment错误的唯一方案。当你同时引用androidx.appcompat和某个老版本第三方 SDK比如百度地图 SDK 3.0时它们都打包了support-v4的 classGradle 会报More than one file was found with OS independent path META-INF/...。exclude不是删掉而是告诉打包器“这些文件我不要”避免冲突。第五区块android.applicationVariants.all注入构建时间戳android.applicationVariants.all { variant - variant.outputs.all { def date new Date().format(yyyyMMdd_HHmmss) outputFileName memo_${variant.name}_${date}.apk } }这行代码让每次构建的 APK 文件名带时间戳避免老师下载多个同名app-debug.apk时覆盖。更重要的是它证明你理解了 Gradle 的 Variant API——这是高级构建脚本的基础。2.3 FileProvider不是“复制粘贴就能用”而是 Android 存储沙盒的通关文牒content://com.baidu.searchbox.fileprovider/...这类 URI 的出现意味着你正在和 Android 的存储沙盒机制打交道。从 Android 7.0API 24开始file://URI 被禁止跨应用传递必须用FileProvider生成content://URI。高分作业的截图里如果导出 PDF 后用微信发送失败90% 是FileProvider配置错误。第一步在AndroidManifest.xml中声明 Providerprovider android:nameandroidx.core.content.FileProvider android:authorities${applicationId}.fileprovider android:exportedfalse android:grantUriPermissionstrue meta-data android:nameandroid.support.FILE_PROVIDER_PATHS android:resourcexml/file_paths / /providerandroid:authorities必须是${applicationId}.fileprovider不能写死成com.example.memo.fileprovider。因为applicationId在build.gradle的defaultConfig里可能被 flavor 修改硬编码会导致不同 flavor 下 URI 不匹配。第二步创建res/xml/file_paths.xml?xml version1.0 encodingutf-8? paths xmlns:androidhttp://schemas.android.com/apk/res/android external-files-path nameexternal_files_path path. / cache-path namecache_path path. / /paths这里有两个致命陷阱external-files-path对应getExternalFilesDir()路径是/storage/emulated/0/Android/data/com.example.memo/files/这是你的 App 私有目录无需申请WRITE_EXTERNAL_STORAGE权限cache-path对应getCacheDir()用于临时文件绝对不能写external-path nameexternal_path path. /external-path指向 SD 卡根目录Android 10 会因Scoped Storage限制直接拒绝访问报错java.lang.SecurityException: Permission Denial。第三步在代码中生成 URIval file File(context.getExternalFilesDir(null), memo_export.pdf) val uri FileProvider.getUriForFile( context, ${context.packageName}.fileprovider, file ) // 发送给微信 val intent Intent(Intent.ACTION_SEND).apply { type application/pdf putExtra(Intent.EXTRA_STREAM, uri) flags Intent.FLAG_ACTIVITY_NEW_TASK or Intent.FLAG_GRANT_READ_URI_PERMISSION } context.startActivity(intent)关键点Intent.FLAG_GRANT_READ_URI_PERMISSION必须设置它临时授予微信读取该 URI 的权限。没有它微信打开文件时会报java.io.FileNotFoundException: open failed: EACCES (Permission denied)。这个 flag 只对本次 Intent 有效不用revokeUriPermission()。注意FileProvider的name属性如external_files_path必须和file_paths.xml中的name完全一致包括大小写。Android Studio 不校验这个但运行时getUriForFile()会抛IllegalArgumentException: Failed to find configured root that contains /data/user/0/com.example.memo/files/memo_export.pdf。3. 实操过程与核心环节实现从零搭建一个可交付的备忘录 App3.1 项目初始化避开 Android Studio 的“默认陷阱”新建项目时Android Studio 的向导页面有 3 个隐藏雷区雷区一“Phone and Tablet” 模板选错必须选Empty Activity而不是 “Basic Activity”。因为 “Basic Activity” 自动生成activity_main.xml带CoordinatorLayoutAppBarLayoutFloatingActionButton看似省事实则埋坑FloatingActionButton的app:layout_anchor属性依赖CoordinatorLayout的 Behavior而你的备忘录不需要悬浮按钮删掉它会导致CoordinatorLayout的Behavior类找不到编译报错Cannot resolve symbol ScrollingViewBehavior。Empty Activity从最简 XML 开始你按需添加。雷区二“Language” 选 Kotlin 还是 Java必须选Kotlin。理由androidx.lifecycle:lifecycle-viewmodel-ktx的by viewModels()委托属性比 Java 的ViewModelProvider(this).get(MemoViewModel::class.java)少写 8 行代码kotlinx-coroutines-android的lifecycleScope.launch自动绑定生命周期避免内存泄漏。高分作业要求代码简洁Kotlin 是事实标准。雷区三“Minimum SDK” 设错向导里默认API 21: Android 5.0 (Lollipop)这是正确选择。如果选API 16: Android 4.1后续引入MaterialButton会报错Class referenced in the manifest, com.google.android.material.button.MaterialButton, was not found in the dependency graph.因为 Material Components 库最低支持 API 21。初始化后立刻做三件事删除app/src/main/res/values/themes.xml里的Theme.AppCompat.Light.DarkActionBar改为Theme.Material3.DayNight—— Material 3 是 Android 12 的设计语言老师截图时会看主题色是否符合 Material 规范在app/src/main/res/values/colors.xml中定义colorPrimary#6750A4紫罗兰主色这是 Material 3 的推荐色修改app/src/main/AndroidManifest.xml的android:theme为style/Theme.Memo指向你新建的主题。3.2 数据层Room 数据库不是“ORM框架”而是 SQLite 的类型安全封装备忘录的数据模型只有Memo一个 Entity但 Room 的配置决定性能和稳定性。Entity 定义Entity(tableName memo_table) data class Memo( PrimaryKey(autoGenerate true) val id: Long 0, ColumnInfo(name title) val title: String , ColumnInfo(name content) val content: String , ColumnInfo(name created_time) val createdTime: Long System.currentTimeMillis(), ColumnInfo(name updated_time) val updatedTime: Long System.currentTimeMillis(), ColumnInfo(name is_pinned) val isPinned: Boolean false, ColumnInfo(name category) val category: String default )关键点PrimaryKey(autoGenerate true)必须用Long不能用Int。SQLite 的AUTOINCREMENT机制要求主键是 64 位整数Int在插入第 2147483647 条记录时会溢出。createdTime和updatedTime用Long存毫秒时间戳比String格式如2023-10-01 12:00:00节省 30% 存储空间且排序更快。DAO 接口Dao interface MemoDao { Insert(onConflict OnConflictStrategy.REPLACE) suspend fun insert(memo: Memo): Long Update suspend fun update(memo: Memo) Delete suspend fun delete(memo: Memo) Query(SELECT * FROM memo_table ORDER BY is_pinned DESC, updated_time DESC) fun getAllMemos(): FlowListMemo Query(SELECT * FROM memo_table WHERE category :category ORDER BY is_pinned DESC, updated_time DESC) fun getMemosByCategory(category: String): FlowListMemo }Insert的onConflict OnConflictStrategy.REPLACE是关键。当用户快速点击两次“保存”按钮可能触发两次insert()如果用ABORT第二次会抛异常用REPLACE则自动删除旧记录再插入新记录保证数据一致性。FlowListMemo返回Flow而不是LiveData因为Flow支持协程取消避免内存泄漏。Database 类Database( entities [Memo::class], version 1, exportSchema true ) abstract class MemoDatabase : RoomDatabase() { abstract fun memoDao(): MemoDao companion object { Volatile private var INSTANCE: MemoDatabase? null fun getDatabase(context: Context): MemoDatabase { return INSTANCE ?: synchronized(this) { INSTANCE ?: buildDatabase(context).also { INSTANCE it } } } private fun buildDatabase(context: Context): MemoDatabase { return Room.databaseBuilder( context.applicationContext, MemoDatabase::class.java, memo_database ).addCallback(object : RoomDatabase.Callback() { override fun onCreate(db: SupportSQLiteDatabase) { super.onCreate(db) // 首次创建数据库时插入默认分类 db.execSQL(INSERT INTO memo_table (title, content, category) VALUES (欢迎使用, 这是您的第一个备忘录, default)) } }).build() } } }exportSchema true生成schemas/目录下的 JSON 文件这是高分作业的加分项——它证明你理解数据库版本迁移机制。addCallback()在onCreate()里插入欢迎笔记避免用户首次打开 App 时看到空列表提升体验。3.3 UI 层CoordinatorLayout 不是“为了好看”而是处理嵌套滚动的物理引擎备忘录的主界面用CoordinatorLayout不是为了炫酷而是解决RecyclerView和AppBarLayout的嵌套滚动冲突。没有它下拉刷新时 toolbar 不会隐藏用户体验降级。activity_main.xml 结构androidx.coordinatorlayout.widget.CoordinatorLayout xmlns:androidhttp://schemas.android.com/apk/res/android xmlns:apphttp://schemas.android.com/apk/res-auto android:layout_widthmatch_parent android:layout_heightmatch_parent com.google.android.material.appbar.AppBarLayout android:layout_widthmatch_parent android:layout_heightwrap_content android:themestyle/ThemeOverlay.Material3.Dark.ActionBar com.google.android.material.appbar.MaterialToolbar android:idid/toolbar android:layout_widthmatch_parent android:layout_height?attr/actionBarSize android:background?attr/colorSurface app:title备忘录 app:navigationIcondrawable/ic_menu app:menumenu/menu_main / /com.google.android.material.appbar.AppBarLayout androidx.recyclerview.widget.RecyclerView android:idid/recyclerView android:layout_widthmatch_parent android:layout_heightmatch_parent app:layout_behaviorstring/appbar_scrolling_view_behavior / com.google.android.material.floatingactionbutton.FloatingActionButton android:idid/fab android:layout_widthwrap_content android:layout_heightwrap_content android:layout_gravitybottom|end android:layout_margin16dp android:srcdrawable/ic_add app:tintandroid:color/white / /androidx.coordinatorlayout.widget.CoordinatorLayout核心是app:layout_behaviorstring/appbar_scrolling_view_behavior。这个字符串值是androidx.coordinatorlayout.widget.CoordinatorLayout$Behavior的内部实现它监听RecyclerView的滚动事件当RecyclerView向上滑动时自动收缩AppBarLayout向下滚动时展开AppBarLayout。如果你用LinearLayout替代CoordinatorLayout这个行为就失效。RecyclerView Adapterclass MemoAdapter : ListAdapterMemo, MemoAdapter.ViewHolder(MemoDiffCallback()) { class ViewHolder(private val binding: ItemMemoBinding) : RecyclerView.ViewHolder(binding.root) { fun bind(memo: Memo) { binding.apply { tvTitle.text memo.title tvContent.text memo.content tvTime.text formatTime(memo.updatedTime) ivPin.visibility if (memo.isPinned) View.VISIBLE else View.GONE } } } override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): ViewHolder { val binding ItemMemoBinding.inflate( LayoutInflater.from(parent.context), parent, false ) return ViewHolder(binding) } override fun onBindViewHolder(holder: ViewHolder, position: Int) { holder.bind(getItem(position)) } } class MemoDiffCallback : DiffUtil.Callback() { override fun getOldListSize(): Int 0 override fun getNewListSize(): Int 0 override fun areItemsTheSame(oldItemPosition: Int, newItemPosition: Int): Boolean TODO(Not yet implemented) override fun areContentsTheSame(oldItemPosition: Int, newItemPosition: Int): Boolean TODO(Not yet implemented) }ListAdapter是关键。它用DiffUtil计算新旧列表差异只刷新变化的 item避免notifyDataSetChanged()全量刷新导致的卡顿。MemoDiffCallback必须实现areItemsTheSame()和areContentsTheSame()否则ListAdapter不工作。正确实现override fun areItemsTheSame(oldItemPosition: Int, newItemPosition: Int): Boolean { return getOldList()[oldItemPosition].id getNewList()[newItemPosition].id } override fun areContentsTheSame(oldItemPosition: Int, newItemPosition: Int): Boolean { return getOldList()[oldItemPosition] getNewList()[newItemPosition] }3.4 系统集成FileProvider 导出 PDF 不是“调用 API”而是跨进程文件共享的契约履行导出 PDF 功能是高分作业的“画龙点睛”之笔它检验你对 Android 文件系统和 Intent 机制的理解。PDF 生成逻辑private fun exportToPdf(memos: ListMemo) { val file File(context.getExternalFilesDir(null), memo_export_${System.currentTimeMillis()}.pdf) try { val document Document(PageSize.A4) val writer PdfWriter.getInstance(document, FileOutputStream(file)) document.open() val font Font(Font.FontFamily.HELVETICA, 12f, Font.NORMAL) for (memo in memos) { document.add(Paragraph(标题${memo.title}, font)) document.add(Paragraph(内容${memo.content}, font)) document.add(Paragraph(时间${formatTime(memo.updatedTime)}, font)) document.add(Paragraph(---, font)) } document.close() // 触发 FileProvider val uri FileProvider.getUriForFile( context, ${context.packageName}.fileprovider, file ) sharePdf(uri) } catch (e: Exception) { Toast.makeText(context, 导出失败${e.message}, Toast.LENGTH_SHORT).show() } }用iText库生成 PDFcompileSdk 34下必须用itext7-core的kernel和layout模块而非老版itextpdf。FileProvider.getUriForFile()是核心前面已详述。分享 Intentprivate fun sharePdf(uri: Uri) { val intent Intent(Intent.ACTION_SEND).apply { type application/pdf putExtra(Intent.EXTRA_STREAM, uri) flags Intent.FLAG_ACTIVITY_NEW_TASK or Intent.FLAG_GRANT_READ_URI_PERMISSION } startActivity(Intent.createChooser(intent, 分享备忘录)) }Intent.createChooser()是必须的。它弹出系统分享面板让用户选择微信、QQ、邮件等 App。如果直接startActivity(intent)在某些定制 ROM如华为 EMUI上会因权限问题崩溃。4. 常见问题与排查技巧实录那些让老师皱眉的“低级错误”4.1 Build 失败类问题Gradle 同步失败的 5 个真实现场问题 1Could not find method android() for arguments [...]现象新建项目后build.gradle第一行plugins { id com.android.application }下划红线提示Could not find method android()。原因build.gradle是 Groovy 脚本但 Android Studio 误判为 Kotlin 脚本。解决右键build.gradle→Override file type→ 选Groovy。这是 Android Studio 的 UI bug重启无效。问题 2Failed to resolve androidx.core:core-ktx:1.12.0现象dependencies里写implementation androidx.core:core-ktx:1.12.0同步时提示Failed to resolve。原因build.gradle顶部的plugins块缺失google()仓库。解决在settings.gradle的dependencyResolutionManagement里确保repositories { google() mavenCentral() }google()仓库托管所有androidx.*库mavenCentral()托管第三方库。顺序不能颠倒否则google()的库可能被mavenCentral()的旧版覆盖。问题 3Execution failed for task :app:processDebugResources现象编译卡在processDebugResourceslogcat 显示AAPT: error: resource android:attr/lStar not found.。原因compileSdk和buildToolsVersion版本不匹配。compileSdk 34必须用buildTools 34.0.0。解决在app/build.gradle的android闭包里加android { compileSdk 34 buildToolsVersion 34.0.0 // 显式指定 }Android Studio 4.2 默认用最新 build-tools但有时缓存旧版显式指定可强制更新。问题 4Duplicate class androidx.lifecycle.ViewModelProvider现象dependencies里同时有androidx.lifecycle:lifecycle-viewmodel和androidx.lifecycle:lifecycle-viewmodel-ktx编译报Duplicate class。原因lifecycle-viewmodel-ktx已包含lifecycle-viewmodel重复引入导致类冲突。解决只保留implementation androidx.lifecycle:lifecycle-viewmodel-ktx:2.6.2删掉lifecycle-viewmodel。问题 5Unable to merge dex现象minSdkVersion设为 16但引入androidx.core:core-ktx:1.12.0编译报Unable to merge dex。原因core-ktx:1.12.0的minSdk是 21与项目minSdk 16冲突。解决将minSdkVersion改为21并检查所有依赖库的minSdk要求用./gradlew app:dependencies查看。4.2 运行时崩溃类问题截图里“闪退”的 3 个高频场景问题 1java.lang.SecurityException: Permission Denial现象点击“导出 PDF”后App 闪退logcat 显示SecurityException: Permission Denial for content://com.example.memo.fileprovider/...。原因FileProvider的android:authorities和代码中getUriForFile()的第二个参数不一致。排查在AndroidManifest.xml中查android:authorities在代码中查getUriForFile(..., ${context.packageName}.fileprovider, ...)两者必须完全相同。问题 2java.lang.IllegalStateException: FragmentManager is already closed现象快速连续点击“添加笔记”按钮然后返回App 崩溃。原因Fragment的FragmentManager在Activity销毁后仍尝试提交事务。解决在Fragment的onCreateView()里用lifecycleScope.launch替代viewLifecycleOwner.lifecycleScope.launch并加if (isAdded) { ... }判断。问题 3android.view.InflateException: Binary XML file line #xx: Error inflating class com.google.android.material.appbar.MaterialToolbar现象App 启动即崩溃logcat 指向MaterialToolbar。原因themes.xml中Theme.Material3.DayNight未正确继承或AndroidManifest.xml的android:theme指向本文还有配套的精品资源点击获取