前言
Atlas已經出了很久，這幾天剛好有個空檔期研究了一下，在沒啥資料的情況下，加了一堆群，踩了一堆坑，終于成功接入了。本文就是記錄接入的過程，并不會講解太多的原理，想要知道原理的前往：官網
主要功能
一、遠程Bundle，就是打包的時候不會把這個bundle打包進去，減少apk的安裝體積，用戶安裝apk后，需要加載那個功能的話，就從網上下載這個bundle的so，然后加載打開，當然下載邏輯是app寫的。適用模塊比較多的app使用，按需加載模塊。
二、熱更新，就是出補丁包，對一個版本進行代碼修改，在不需要用戶更新apk的情況下完成更新。
開始接入
一、新建一個項目，然后新建幾個module，如下圖
二、配置
1、把gradle改為3.3
2、項目級的build
buildscript {
repositories {
jcenter()
mavenLocal()//本地maven
}
//引入啊里的依賴，不需要再依賴classpath "com.android.tools.build:gradle"的版本，默認使用的是 2.1
dependencies {
classpath "com.taobao.android:atlasplugin:2.3.1.rc9"
}
}
allprojects {
repositories {
jcenter()
mavenLocal()//本地maven
}
}
task clean(type: Delete) {
delete rootProject.buildDir
}
3、app的build
// 需要放最上面初始化
group = "mmc.atlastest"
version = getEnvValue("versionName", "1.0.0");
def apVersion = getEnvValue("apVersion", "");
apply plugin: 'com.android.application'
apply plugin: 'com.taobao.atlas'
android {
compileSdkVersion 25
buildToolsVersion "25.0.2"
defaultConfig {
applicationId "mmc.atlastest"
minSdkVersion 15
targetSdkVersion 25
versionCode 1
versionName version
testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
}
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
}
}
dependencies {
compile fileTree(include: ['*.jar'], dir: 'libs')
androidTestCompile('com.android.support.test.espresso:espresso-core:2.2.2', {
exclude group: 'com.android.support', module: 'support-annotations'
})
compile 'com.android.support:appcompat-v7:25.3.1'
testCompile 'junit:junit:4.12'
//atlas的依賴
compile('com.taobao.android:atlas_core:5.0.7@aar') {
transitive = true
}
compile 'com.taobao.android:atlasupdate:1.1.4.7@aar'
compile 'com.alibaba:fastjson:1.1.45.android@jar'
//項目依賴
compile project(':librarybundle')
compile project(':localbundle')
compile project(':remotebundle')
}
//加入以下配置
atlas {
atlasEnabled true
tBuildConfig {
// autoStartBundles = ['com.android.homebundle'] //自啟動bundle配置
outOfApkBundles = ['remotebundle'] //遠程module，列表來的，可填多個
preLaunch = 'mmc.atlastest.AtlasLaunch' //AppApplication啟動之前調用，這個類下面放出代碼
}
patchConfigs {
debug {
createTPatch true
}
}
buildTypes {
debug {
if (apVersion) {
// 打差異補丁 gradlew assembleDebug -DapVersion=1.1.0 -DversionName=1.1.1
// 對應著本地maven倉庫地址 .m2/repository/mmc/atlastest/AP-debug/1.1.4/AP-debug-1.1.4.ap
baseApDependency "mmc.atlastest:AP-debug:${apVersion}@ap"
patchConfig patchConfigs.debug
}
}
}
}
String getEnvValue(key, defValue) {
def val = System.getProperty(key);
if (null != val) {
return val;
}
val = System.getenv(key);
if (null != val) {
return val;
}
return defValue;
}
apply plugin: 'maven'
apply plugin: 'maven-publish'
publishing {
// 指定倉庫位置
repositories {
mavenLocal()
}
publications {
// 默認本地倉庫地址 用戶目錄/.m2/repository/
maven(MavenPublication) {
//讀取ap目錄上傳maven
artifact "${project.buildDir}/outputs/apk/${project.name}-debug.ap"
//生成本地maven目錄
groupId group
artifactId "AP-debug"
}
}
}
4、遠程bundle和本地bundle的build
apply plugin: 'com.android.library'
apply plugin: 'com.taobao.atlas'
atlas {
bundleConfig{
awbBundle true
}
buildTypes {
debug {
baseApFile project.rootProject.file('app/build/outputs/apk/app-debug.ap')
}
}
}
//只添加上面的配置就行了，下面的是默認生成的
android {
compileSdkVersion 25
buildToolsVersion "25.0.2"
defaultConfig {
minSdkVersion 15
targetSdkVersion 25
versionCode 1
versionName "1.0"
testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
}
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
}
}
dependencies {
compile fileTree(include: ['*.jar'], dir: 'libs')
androidTestCompile('com.android.support.test.espresso:espresso-core:2.2.2', {
exclude group: 'com.android.support', module: 'support-annotations'
})
compile 'com.android.support:appcompat-v7:25.3.1'
testCompile 'junit:junit:4.12'
//依賴lib中間bundle
compile project(':librarybundle')
}
5、application里面添加
public class DemoApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
Atlas.getInstance().setClassNotFoundInterceptorCallback(new ClassNotFoundInterceptorCallback() {
@Override
public Intent returnIntent(Intent intent) {
final String className = intent.getComponent().getClassName();
final String bundleName = AtlasBundleInfoManager.instance().getBundleForComponet(className);
if (!TextUtils.isEmpty(bundleName) && !AtlasBundleInfoManager.instance().isInternalBundle(bundleName)) {
//遠程bundle
Activity activity = ActivityTaskMgr.getInstance().peekTopActivity();
File remoteBundleFile = new File(activity.getExternalCacheDir(),"lib" + bundleName.replace(".","_") + ".so");
String path = "";
if (remoteBundleFile.exists()){
path = remoteBundleFile.getAbsolutePath();
}else {
Toast.makeText(activity, " 遠程bundle不存在，請確定 : " + remoteBundleFile.getAbsolutePath() , Toast.LENGTH_LONG).show();
return intent;
}
PackageInfo info = activity.getPackageManager().getPackageArchiveInfo(path, 0);
try {
Atlas.getInstance().installBundle(info.packageName, new File(path));
} catch (BundleException e) {
Toast.makeText(activity, " 遠程bundle 安裝失敗，" + e.getMessage() , Toast.LENGTH_LONG).show();
e.printStackTrace();
}
activity.startActivities(new Intent[]{intent});
}
return intent;
}
});
}
}
6、在app新建一個類AtlasLaunch，繼承AtlasPreLauncher
public class AtlasLaunch implements AtlasPreLauncher {
@Override
public void initBeforeAtlas(Context context) {
}
}
三、然后寫app的基本功能，示例如下圖：
public class MainActivity extends BaseActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}
//打開遠程bundle
public void remote(View view){
Intent intent = new Intent();
intent.setClassName(view.getContext(), "mmc.remotebundle.RemoteActivity");
startActivity(intent);
}
//打開本地bundle
public void local(View view){
Intent intent = new Intent();
intent.setClassName(view.getContext(), "mmc.localbundle.LocalActivity");
startActivity(intent);
}
//更新補丁
public void update(View view){
new AsyncTask<Void, Void, Void>() {
@Override
protected Void doInBackground(Void... voids) {
update();
return null;
}
@Override
protected void onPostExecute(Void aVoid) {
Toast.makeText(MainActivity.this, "更新完成，請重啟", Toast.LENGTH_LONG).show();
}
}.execute();
}
private void update(){
File updateInfo = new File(getExternalCacheDir(), "update.json");
if (!updateInfo.exists()) {
showToast("更新信息不存在，請先 執行 buildTpatch.sh");
return;
}
String jsonStr = new String(FileUtils.readFile(updateInfo));
UpdateInfo info = JSON.parseObject(jsonStr, UpdateInfo.class);
File patchFile = new File(getExternalCacheDir(), "patch-" + info.updateVersion + "@" + info.baseVersion + ".tpatch");
try {
AtlasUpdater.update(info, patchFile);
} catch (Throwable e) {
e.printStackTrace();
showToast("更新失敗, " + e.getMessage());
}
}
}
四、安裝運行這個版本的apk，界面如下：
1、這個時候點擊遠程bundle會彈出說沒有so文件，因為還沒打so包呢
2、點擊本地bundle，是可以跳轉到那個本地bundle頁面
3、點擊更新補丁，會提示更新信息不存在
重點來了
下面要打包出遠程bundle的so文件，補丁的差異包和更新說明
1、打so文件，每個遠程都會生成一個so文件的。打開AS的Terminal，輸入：gradlew clean assembleDebug publish
，然后回車，如下圖：
正常的話，會提示這個：
如果提示下面這個錯
那就把java進程全部殺掉，然后重試，原因是為啥，我也不知道
成功的話，app的build文件夾里，會生成這個so文件，這個就是遠程bundle的so文件，把這個文件放到手機內存卡Android/data/mmc.atlastest/cache 文件夾里面，然后再打開app，點擊“遠程Bundle”，這個時候就能跳轉過去了。
2、更新補丁，打差異包和更新說明
接著第一步，然后修改版本號，對本地Bundle進行文字修改，對app主項目也可以修改（修改已有的Activity）
修改后，在Terminal里面輸入：gradlew clean assembleDebug -DapVersion=1.0.0 -DversionName=1.0.1
回車，成功后會生成補丁差異包和更新說明，如下圖：
把紅色圈中的兩個文件，放到手機內存卡Android/data/mmc.atlastest/cache 文件夾里面，然后點擊“更新補丁”，過一會，提示更新成功后，就退出殺死app，再打開就是后面修改的內容了。
這樣就完成更新過程了，完整源碼：AtlasTest
總結步驟
1、配置好，安裝1.0.0的app
2、用命令“gradlew clean assembleDebug publish”打AP，得到遠程Bundle的so文件
3、修改版本號，修改版本內容
4、用命令“gradlew clean assembleDebug -DapVersion=1.0.0 -DversionName=1.0.1”打差異包補丁和更新說明
5、把上面得到的三個文件放到app的cache目錄里面
6、運行更新方法，殺死app，重啟
