記錄一下 Android sdk 開發(fā)中的一些問題,雖然不難但是對于第一次開發(fā) sdk 的人來說還是有不少要注意的地方的。
前段時(shí)間由于要和外部公司合作,需要我們提供一個(gè) sdk 能夠加載我們自己的 h5 頁面,調(diào)用起我們的 app,跳轉(zhuǎn)到指定頁面等等功能。然后這個(gè)封裝一個(gè) webview 的“簡單 sdk 任務(wù)”就落到我的頭上了,用 webview 加載頁面還好,但是封裝 sdk 還真沒做過。 當(dāng)然還有交付個(gè) aar 過去之后,對方說他們用的是 eclipse 開發(fā)的,導(dǎo)入的問題,因?yàn)槲易约河玫墓ぞ呤?AndroidStudio。
需求
簡單分析一下那么需求也就出來了:
- 需要 webview 那么就有 js 的交互,那么混淆就要注意了(其實(shí)里面的業(yè)務(wù)邏輯比較簡單,奈何要給出去顯得高大上,所以要求混淆,手動(dòng)滑稽);
- 有自己的頁面,也就涉及到資源的問題;
- 支持 AndroidStudio 和 Eclipse 的導(dǎo)入。
混淆
除了一些通用的混淆規(guī)則,我們還要注意引用了的 jar 包的混淆規(guī)則,還有 JsInterface,以及我們需要開放出去的 api 的混淆規(guī)則。
資源
對于提供出去的 sdk 在資源命名的時(shí)候最好加上自己的前綴,以防和使用方的資源名重復(fù)。對于 AndroidStudio 來說可以在 module 的 build 里面加上 resourcePrefix,當(dāng)我們的資源沒有加前綴的時(shí)候就能得到提醒。
apply plugin: 'com.android.library'
android {
//... 省略
resourcePrefix 'dt_'
}
對于 AndroidStudio 來說我們可以提供 arr,里面自帶資源;對于 Eclipse 來說我們除了提供 jar 包之外,還要提供所用到的資源文件。
對于希望自己能修改一些資源文件起到自定義作用的 AndroidStudio 用戶也可以和 Eclipse 一樣依賴 jar 包。
采用 jar 包依賴的方式,我們不能直接將所有資源文件拷貝到將要用到的工程里,而要新建一個(gè)項(xiàng)目然后保證包名與我們的 sdk 包名一致,然后把資源拷貝進(jìn)來,保證 R 文件能正確引用到。
但是 jar 如果不進(jìn)行混淆的話 BuildConfig 就需要我們在打 jar 包的時(shí)候去除了,因?yàn)槲覀優(yōu)榱苏_引用到資源要求導(dǎo)入的時(shí)候建立了一個(gè)和 sdk 包名一致的項(xiàng)目,所以這個(gè)時(shí)候就會(huì)有兩個(gè) BuildConfig 類而且它們包名一致(一個(gè)在 jar 里面,一個(gè)在新建的 module 里面)。
因?yàn)槲也捎昧嘶煜钥梢院雎詢蓚€(gè) BuildConfig 的問題,不用在打 jar 包的時(shí)候處理 BuildConfig,因?yàn)槭褂玫臅r(shí)候 jar 包里的可能已經(jīng)被混淆成 a 了。
至于我上面所說的 jar 包,就是 assembleRelease 之后在 build-outputs-aar 里面的 aar 解壓出來的 classes.jar,也就是要提供的 aar 里面直接解壓出來的。
Eclipse 導(dǎo)入
Eclipse 不能依賴 aar,在寫 sdk 的時(shí)候要盡量避免用到 v7 包,因?yàn)槔锩鎺Я速Y源。我在知道合作方公司用Eclipse 的時(shí)候特地又去下載了一個(gè),發(fā)現(xiàn) v7 包的引入比較麻煩,原諒我太久沒接觸這個(gè)工具了!所以連夜把我的 sdk 用到 v7 的地方都給修改了。
盡量使用 23 以上的 v4 包,因?yàn)橛袡?quán)限管理適配,這個(gè)指不定你會(huì)不會(huì)用到。
下邊看下提供給 Eclipse 導(dǎo)入的文件:
sdk
├── libs
│ ├── sdk.jar
│ └── android-support-v4.jar
├── res
│ └── ***
├── assets
│ └── ***
├── .classpath
├── .project
├── AndroidManifest.xml
└── project.properties
- sdk.jar 就是我們要提供的 jar 包
- res 就是我們需要的資源文件
- .classpath
<?xml version="1.0" encoding="UTF-8"?>
<classpath>
<classpathentry exported="true" kind="con" path="com.android.ide.eclipse.adt.ANDROID_FRAMEWORK"/>
<classpathentry exported="true" kind="con" path="com.android.ide.eclipse.adt.LIBRARIES"/>
<classpathentry exported="true" kind="con" path="com.android.ide.eclipse.adt.DEPENDENCIES"/>
<classpathentry kind="src" path="src"/>
<classpathentry kind="src" path="gen"/>
<classpathentry kind="output" path="bin/classes"/>
</classpath>
- .project 中 name 節(jié)點(diǎn)改成需要的 sdk 名稱
<?xml version="1.0" encoding="UTF-8"?>
<projectDescription>
<name>sdklib</name>
<comment></comment>
<projects>
</projects>
<buildSpec>
<buildCommand>
<name>com.android.ide.eclipse.adt.ResourceManagerBuilder</name>
<arguments>
</arguments>
</buildCommand>
<buildCommand>
<name>com.android.ide.eclipse.adt.PreCompilerBuilder</name>
<arguments>
</arguments>
</buildCommand>
<buildCommand>
<name>org.eclipse.jdt.core.javabuilder</name>
<arguments>
</arguments>
</buildCommand>
<buildCommand>
<name>com.android.ide.eclipse.adt.ApkBuilder</name>
<arguments>
</arguments>
</buildCommand>
</buildSpec>
<natures>
<nature>com.android.ide.eclipse.adt.AndroidNature</nature>
<nature>org.eclipse.jdt.core.javanature</nature>
</natures>
</projectDescription>
- project.properties
target=android-23
android.library=true
將得到的 sdk 文件夾作為庫工程模塊導(dǎo)入到工程中,并添加模塊依賴。然后將 assets 文件夾的內(nèi)容拷貝到主工程的 assets 目錄中,將 AndroidManifest 文件中的內(nèi)容拷貝到你的主工程的 manifest 文件中。
最后
期間參考了市面上一些 sdk 的導(dǎo)入方法,還特意搭建了 eclipse 的環(huán)境導(dǎo)入了一下。完成后,想想兩個(gè)工具只是目錄結(jié)構(gòu)不太一樣,所以只要解決了混淆和資源引用的問題后稍微調(diào)整下結(jié)構(gòu)就通用了,最后還是感慨下 gradle 解決依賴問題真的太舒服了。