离线 Android Studio 环境

背景

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

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

离线环境搭建

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

配置 SDK

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

sdk
配置 gradle

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

配置依赖

下载官方的 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
}