如何在Android Studio中搭建并运行GitHub上的dmix/mpdroid项目

一、环境适配准备 #

• 安装Android Studio Arctic Fox 或更低版本（旧项目依赖的Gradle、SDK版本通常不兼容新版AS，选适配旧Gradle的版本可避免大部分兼容性报错）
• 打开File > Settings > Appearance & Behavior > System Settings > Android SDK，安装项目对应SDK版本：先看项目根目录build.gradle里的compileSdkVersion和targetSdkVersion，勾选对应SDK及配套Build Tools
• 配置JDK 8：在File > Project Structure > SDK Location中，将JDK路径指向JDK 8安装目录（旧项目基本依赖JDK 8）

二、项目克隆与导入配置 #

• 打开AS选择Get from Version Control，克隆项目到本地
• 克隆完成后先修改配置再同步：
  • 根目录build.gradle（Project级）：修改distributionUrl为项目兼容的Gradle版本，比如原项目用Gradle 4.x就改为https\://services.gradle.org/distributions/gradle-4.10.1-all.zip
  • 模块build.gradle（Module级）：将compile替换为implementation、testCompile替换为testImplementation；把compileSdkVersion、buildToolsVersion改成你已安装的对应版本

三、依赖与同步问题解决 #

• 点击AS右上角Sync Project with Gradle Files开始同步
• 依赖下载失败：在根目录build.gradle的repositories块添加国内镜像源：

  maven { url 'https://maven.aliyun.com/repository/public' }
  maven { url 'https://maven.aliyun.com/repository/google' }
  

  检查libs目录下的本地依赖文件是否齐全，缺失则补充对应.jar/.aar文件
• NDK报错：在local.properties中添加ndk.dir=/path/to/your/ndk（路径为AS安装目录下对应版本NDK，比如r16b），或在SDK Manager安装对应NDK版本

四、项目运行 #

• 连接调试设备（真机需开USB调试，模拟器选对应API版本）
• 点击Run 'app'选择目标设备，等待编译安装
• 运行崩溃时查看Logcat错误信息：比如权限缺失就在AndroidManifest.xml添加权限并补全动态请求代码；资源报错就检查布局、字符串文件的语法问题

内容的提问来源于stack exchange，提问作者cat Man