背景

一个涉密项目，网络传输通信全都是内部的，要求在无法联网的设备上先搭建一套开发环境给对方使用。

先在能联网的 Windows 电脑上创建项目，下载好依赖，编译到能够运行。然后在断网的虚拟机上做测试。

离线环境搭建

在没有网络的设备上，安装好 Android Studio。

1. 配置 SDK 打开之前的工程，会提示没有 SDK，或者在下图右下角点击 Configure，选择 Default Project Structure... 设置 SDK。

sdk

1. 配置 gradle 将原来的 ./gradle 下的 wrapper 复制到断网设备上的对应目录。或者修改 gradle-wrapper.properties 的配置，比如 distributionUrl = file:///C:/Users/Administartor/Desktop/gradle-5.6.4.zip
2. 配置依赖 下载官方的 Offline components解压到用户目录下的 .android/manual-offline-m2/，然后参考配置离线编译依赖项，在 .gradle 中创建文件 init.d/offline.gradle，内容为 def reposDir = new File(System.properties['user.home'], ".android/manual-offline-m2") def repos = new ArrayList() reposDir.eachDir {repos.add(it) } repos.sort() allprojects { buildscript { repositories { for (repo in repos) { maven { name = "injected_offline_${repo.name}" url = repo.toURI().toURL() } } } } repositories { for (repo in repos) { maven { name = "injected_offline_${repo.name}" url = repo.toURI().toURL() } } } } 然后将工程下的 build.gradle 中 repositories 中的内容注释掉 android { repositories { // google() // jcenter() } } allprojects { repositories { // google() // jcenter() } } 接着同步，看报错信息，将原项目 ./gradle/caches/modules-2/files-2.1 里对应的 jar 移到报错缺少的地方。比如报错信息

GradleVersion 那就找到 com.android.tools.build/gradle/3.6.1。有些库如果只有 jar 或者只有 pom，将一个复制过去就行。 测试其实可以直接将依赖改成本地的 mavenLocal()，然后看提示报错将对应的文件复制过去就行。官网的 manual-offline-m2 里有太多老旧版本依赖，根本用不上。 复制的太麻烦了，所以写个 Python 脚本将里面所有文件复制到一个地方，然后直接复制到离线设备的对应目录。 import os import shutil def findCopy(filePath): if os.path.isfile(filePath): parent = os.path.dirname(filePath) fileName = filePath[len(parent):] # 文件名 newFilePath = os.path.dirname(parent) + fileName # 把类似28eb83e6a29ac3fbb87aa632cfa0e644a313f491这一串去除 newParent = r'C:UsersAdministartorDesktopgradle' # 要保存的新的目录 tempPath = newFilePath[len(path)+1:] # 把 C:UsersThunisoft.gradlecachesmodules-2files-2.1 去掉 pos = tempPath.find('\') first = tempPath[:pos].replace('.','\') # 第一层类似 androidx.activity 这种要变成多级目录 destPath = newParent + '\' + first + tempPath[pos:] # 要保存的文件路径 destParent = os.path.dirname(destPath) if not os.path.exists(destParent): os.makedirs(destParent) # 创建文件夹 if not os.path.exists(destPath): shutil.copyfile(filePath, destPath) # 文件不存在时复制 print("copy to " + destPath) else: list = os.listdir(filePath) # list 只是文件名 for i in range(len(list)): findCopy(os.path.join(filePath, list[i])) # 拼出全路径 path = r'C:UsersAdministrator.gradlecachesmodules-2files-2.1' findCopy(path)

问题

碰到一个极其坑爹的问题 Unable to load class 'com.android.ide.common.repository.GradleVersion'，卡了好几天，进 Help->Show Log in Explorer 看日志，说什么 GradleVersionCheckPlugin 去检查时找不到这个类，原来项目 gradle tool 是 3.6.1，gradle.zip 是 5.6.4 的，后来想着用创建新项目默认的 4.0.1 和 6.1.1 试试，就没出现这 bug 了，看来还是版本问题。

离线环境设备保 lint 有 jar 包没找到，但是在有网环境的依赖里没有对应 jar 包，在工程 build.gradle 中加上如下配置，屏蔽 lint 检查。

lintOption {
    checkReleaseBuilds false
    abortOnError false
}