引言
我们日常工作中在网络畅通的情况下，大家都会选择在线下载依赖。但是，几乎每个人都遇到过被墙或者网络掉链子的情况。这时android studio 可能会因为依赖包下载不了而出现编译报错。配置离线组件就可以用来应付这种紧急情况，不至于因为依赖包无法下载而没法工作。本文就介绍如何配置android studio离线组件。
1. 离线组件
下载离线组件(Offline components)，google 官方地址：https://developer.android.google.cn/studio#downloads
下载后，解压到%USER_HOME%/.android路径：
Windows：
C:\Users[user_name]\.android\manual-offline-m2\gmaven_stable
Mac/Linux：
~/.android/manual-offline-m2/gmaven_stable
其中manual-offline-m2和gmaven_stable两级目录需要自行新建，命名不是强制固定的，但一定要确保存放在%USER_HOME%/.android下，并且要确保.android到具体的依赖包如：android、androidx、com、org等中间还有两级目录。
2. 离线配置文件
在%USER_HOME%/.gradle目录下新建init.d目录，然后在init.d目录下新建offline.gradle文件。
Windows：
C:\Users[user_name]\.gradle\init.d\offline.gradle
Mac/Linux：
~/.gradle/init.d/offline.gradle
offline.gradle文件内容如下：
def reposDir = new File("C:/Users/administrator", ".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()
}
}
}
}
注意：
offline.gradle中的路径，需要改为自己电脑的离线组件路径
这里整理了一个android studio 3.2.1实测可用的离线依赖包，理论上android studio 3.5及其以下版本都可以使用。
链接: https://pan.baidu.com/s/1mN3IRw4kYOg6PYxrvyqEcw
提取码: wi5e
其中含离线组件和配置文件，下载后解压到%USER_HOME%，将下载的.android和.gradle与原有.android和.gradle合并，然后修改一下offline.gradle中的路径即可。
3. 离线编译
配置好离线组件，我们就可以离线编译了。离线编译前需要把Project的build.gradle文件中的google()和jcenter()注释掉，这样就会默认使用离线组件。除此之外，在使用上离线编译和在线编译没有任何区别。
// Top-level build file where you can add configuration options common to all sub-projects/modules.
buildscript {
repositories {
/*google()
jcenter()*/
}
dependencies {
classpath 'com.android.tools.build:gradle:3.2.1'
// NOTE: Do not place your application dependencies here; they belong
// in the individual module build.gradle files
}
}
allprojects {
repositories {
/*google()
jcenter()*/
}
}
task clean(type: Delete) {
delete rootProject.buildDir
}
另外，再分别贴上app中support版本和androidx版本的build.gradle版本配置，android studio 3.2.1实测离线编译通过。
support:
dependencies {
implementation fileTree(dir: 'libs', include: ['*.jar'])
implementation 'com.android.support:appcompat-v7:28.0.0'
implementation 'com.android.support.constraint:constraint-layout:1.1.0'
testImplementation 'junit:junit:4.12'
androidTestImplementation 'com.android.support.test:runner:1.0.2'
androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'
}
androidx:
dependencies {
implementation fileTree(dir: 'libs', include: ['*.jar'])
implementation 'androidx.appcompat:appcompat:1.0.2'
implementation 'androidx.constraintlayout:constraintlayout:1.1.3'
testImplementation 'junit:junit:4.12'
androidTestImplementation 'androidx.test:runner:1.1.1'
androidTestImplementation 'androidx.test.espresso:espresso-core:3.1.1'
}
注意，离线编译只能使用离线组件目录中已有的组件，基本上只有android studio的默认组件，很少第三方组件。如果项目需要第三方组件，需要自己手动下载。当然，你也可以在网络好的情况下，下载好项目所需的全部组件，然后拷贝到离线组件目录下，这样下次网络不好的情况下，你的项目仍然能正常离线编译。显然，这样是非常麻烦的。我的建议是：在网络畅通的情况下，要毫不犹豫地选择在线编译。只有在网络完全不行的情况下，才考虑使用离线编译。
4. 更新离线组件
更新离线组件的步骤：
- a. 到官网重新下载新的离线组件(Offline components)：https://developer.android.google.cn/studio#downloads
- b. 解压下载的新的离线组件压缩包，将解压出的内容：android、androidx、com、org等等拷贝到%USER_HOME%\manual-offline-m2\gmaven_stable 目录中。
这里为了保持版本兼容性，没有按官网教程直接删掉原有依赖组件，而是选择将新旧版本合并，这样合并之后，新旧版本的依赖包，我们就都有了，这样将会有更好的兼容性。
5. 参考
https://developer.android.google.cn/studio/intro/studio-config#offline
https://developer.android.google.cn/studio#downloads
