Android 插件框架機制系列文章:
Android 插件框架機制之預熱篇
引言
上一篇文章提到過Small,這次就簡單說一下Small,這只是一篇入門的文章,如果想深入了解,可以下載官方demo,里面會有詳細的示例。
官方demo
我是用AS打開的這個demo,如圖所示:
工程結構如圖所示:
第一次運行demo會提示如下問題:
這是我們打開AS自帶的終端:
輸入gradle命令,進行編譯,這些需要注意的是的,如果使用的是windows使用./gradlew,如果使用的mac或linux,使用gradle即可:
gradle buildLib -q
gradle buildBundle -q
最后輸入這個命令查看插件情況:
gradle small
如果此時你的終端有如下顯示,則表明正確:
注意,如果你們有使用AS自帶的終端,請切到項目目錄下輸入這些命令
此時再運行,就會看到如下界面了:
入門教學
新建工程
在工程下的build.gradle(注意是project的不是module的),進行修改如下
buildscript {
repositories {
jcenter()
}
dependencies {
classpath 'com.android.tools.build:gradle:2.1.2'
classpath 'net.wequick.tools.build:gradle-small:1.1.0-alpha2'//添加依賴
}
}
allprojects {
repositories {
jcenter()
}
}
task clean(type: Delete) {
delete rootProject.buildDir
}
//引用 gradle-small 插件
apply plugin: 'net.wequick.small'
small {
buildToAssets = false
aarVersion = '1.1.0-alpha2'
android {
compileSdkVersion = 23
buildToolsVersion = "23.0.3"
supportVersion = "23.4.0"
}
}
可以像上面講解demo中提到過的一樣,在終端輸入:
gradle small
看看是否編譯正常。
配置宿主
我們新建的這個工程中有一個app module,假設這就是我們的宿主應用,即主應用,我們在該module中新建Application:
public class DeepApp extends Application{
public DeepApp(){
Small.preSetUp(this);//初始化Small
}
@Override
public void onCreate() {
super.onCreate();
}
}
再在 AndroidManifest.xml 中指定這個 Application。
<application
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:supportsRtl="true"
android:name=".DeepApp"
android:theme="@style/AppTheme">
<activity android:name=".MainActivity">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
</application>
模塊插件
我們新建立一個module,選擇Phone & Tablet Module
,設置 Application/Library name 為 App.main,此時 Module name 自動為 app.main,如圖所示:
了確認我們確實啟動了插件,我們修改插件的布局文件 app.main > res > layout > activity_main.xml,將 TextView 的內容改為 Hello deep!
編譯插件
像我們上面講解demo中提到的一樣,在終端進行編譯:
gradle buildBundle -q
關聯插件
現在我們已經生成了插件并內置到宿主包中,要啟動插件,我們需要配置一個路由來指向它。
右鍵 app 模塊,New > Folder > Assets Folder 新建 assets 目錄:
在bundle.json文件中添加如下代碼:
{
"version": "1.0.0",
"bundles": [
{
"uri": "main",
"pkg": "deep.appmain"
},
]
}
- version,是 bundle.json 文件格式版本,目前始終為 1.0.0
- bundles,插件數組
- uri,插件唯一ID
- pkg,插件包名
運行
然后回到app module中,找到MainActivity,重寫onStart():
Small.setUp(this, new Small.OnCompleteListener() {
@Override
public void onComplete() {
Small.openUri("main", MainActivity.this);
}
});
main就是剛才bundle.json中uri的參數。說明我們要啟動main這個module的MainActivity。
由于我之前做過別的設置,所以發現點擊運行報錯了,這時我們需要清除之前的編譯:
gradle cleanLib -q
然后重新編譯,即可運行。
總結
所有關于Small的講解,在官方文檔上說的非常詳細,我之前也沒有用過,但是前幾天總結插件框架的時候發現的這個,就去看了看,不算很難上手,而且Android IOS都會支持。需要的朋友,建議利用官方文檔入門,然后在分析一下他的demo即可,涵蓋的功能很全面。
這里再放一下地址:
官方文檔
官方demo