如何在Android Studio中运行FrescoImageViewer示例项目

作为有多年跨平台开发经验的老手，你肯定懂不同开发环境的“水土不服”——Android Studio的导入逻辑有时候确实有点反直觉，我来帮你一步步解决这个问题：

第一步：用Git克隆项目（别直接下压缩包！） #

直接下载压缩包很容易遗漏依赖关联或者Git子模块（虽然这个项目不一定有，但克隆是更稳妥的方式）。打开终端执行命令：
git clone https://github.com/stfalcon-studio/FrescoImageViewer.git

第二步：正确导入项目 #

别用「File -> New Project -> Import Project」这个路径！ Android Studio的这个入口是为了导入非Gradle项目的，而FrescoImageViewer本身就是标准的Android Gradle项目，应该：

• 打开Android Studio，选择「File -> Open」
• 直接选中你克隆好的项目根目录，点击「OK」

第三步：等待Gradle同步（解决同步慢/失败的问题） #

第一次打开项目，Android Studio会自动同步Gradle并下载所有依赖。如果同步速度极慢或者失败，大概率是仓库源的问题，修改根目录下的build.gradle文件，把默认的仓库替换成国内镜像：

buildscript {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
        maven { url 'https://maven.aliyun.com/nexus/content/groups/public' }
    }
    // ... 其他代码不变
}

allprojects {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
        maven { url 'https://maven.aliyun.com/nexus/content/groups/public' }
    }
    // ... 其他代码不变
}

修改后点击Sync Now按钮重新同步。

第四步：解决常见同步错误 #

如果同步后还是有红色错误，优先排查这几个点：

• SDK版本不匹配：打开app/build.gradle，把compileSdkVersion、targetSdkVersion改成你本地Android SDK管理器中已安装的最新稳定版本（比如34），minSdkVersion可以根据你的需求调低（比如21，确保你有对应的SDK）。
• Gradle版本不兼容：根目录gradle/wrapper/gradle-wrapper.properties里的distributionUrl对应的Gradle版本，要和Android Studio的Gradle插件版本匹配（比如插件版本是7.4.2，Gradle用7.5版本）。如果不知道对应关系，可以直接在Android Studio的提示里点击「Upgrade Gradle」自动修复。
• 依赖冲突：如果日志里出现Conflict with dependency 'com.facebook.fresco:fresco'这类提示，在app/build.gradle的依赖里统一指定Fresco版本，或者用exclude排除冲突的依赖：

  implementation('com.github.stfalcon:frescoimageviewer:0.5.0') {
      exclude group: 'com.facebook.fresco'
  }
  

最后：运行示例 #

同步完成后，确保选中app模块，点击右上角的运行按钮，选择你的模拟器或者真机，就能正常运行示例项目了。

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