背景

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

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

离线环境搭建

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

1. 配置 SDK

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

   sdk

2. 配置 gradle

   将原来的 ./gradle 下的 wrapper 复制到断网设备上的对应目录。或者修改 gradle-wrapper.properties 的配置，比如 distributionUrl = file\:///C:/Users/Administartor/Desktop/gradle-5.6.4.zip

3. 配置依赖

   下载官方的 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:\Users\Administartor\Desktop\gradle' # 要保存的新的目录
       tempPath = newFilePath[len(path)+1:] # 把 C:\Users\Thunisoft\.gradle\caches\modules-2\files-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:\Users\Administrator\.gradle\caches\modules-2\files-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
}