Android 自動(dòng)更新 SDK快速開始

本文檔幫助您以最快速最簡潔的方式集成使用自動(dòng)更新組件。

1. 導(dǎo)入SDK所需jar包

下載最新版SDK的zip包，將其中的libs文件夾合并到本地工程libs子目錄下。

Eclipse用戶右鍵工程根目錄，選擇Properties -> Java Build Path -> Libraries，然后點(diǎn)擊Add External JARs... 選擇指向jar的路徑，點(diǎn)擊OK，即導(dǎo)入成功。

注意

Eclipse ADT 17 以上版本用戶，不要通過上述步驟手動(dòng)添加jar包引用。請?jiān)诠こ棠夸浵陆ㄒ粋€(gè)文件夾libs，把jar包直接拷貝到這個(gè)文件夾下，再在Eclipse里面刷新一下工程就好了。詳情請參考Dealing with dependencies in Android projects.

libs目錄下的libs/armeabi/libbspatch.so文件是用于支持增量更新功能的庫文件，也需要在eclipse中添加。

2. 添加資源文件

將SDK提供的res文件夾拷入工程目錄下, 和工程本身res目錄合并。請不要隨便刪除其中的文件。

提示

友盟SDK提供的資源文件都以umeng_開頭。

3. 配置AndroidManifest.xml

3.1 打開AndroidManifest.xml，添加SDK需要的權(quán)限到標(biāo)簽下：

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE">uses-permission>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE">uses-permission>
<uses-permission android:name="android.permission.INTERNET">uses-permission>

android.permission.WRITE_EXTERNAL_STORAGE 權(quán)限允許將下載的apk保存到sd卡中。
android.permission.ACCESS_NETWORK_STATE 權(quán)限允許檢查網(wǎng)絡(luò)狀態(tài)，從而根據(jù)不同網(wǎng)絡(luò)環(huán)境決定何種下載策略,務(wù)必添加該權(quán)限。

3.2 添加APPKEY和渠道到標(biāo)簽下： （如果已經(jīng)集成了統(tǒng)計(jì)SDK等友盟其他服務(wù)，不需要重復(fù)添加APPKEY）

<meta-data android:value="YOUR APP KEY" android:name="UMENG_APPKEY"/>
<meta-data android:value="Channel ID" android:name="UMENG_CHANNEL"/>

UMENG_APPKEY：用來定位該應(yīng)用的唯一性，用您該應(yīng)用的UMENG APPKEY，替換value中的"YOUR APP KEY"。
UMENG_CHANNEL：用來標(biāo)注應(yīng)用推廣渠道，不同渠道可以上傳不同更新包，您可以使用20位以內(nèi)的英文和數(shù)字為渠道定名，替換value中的"Channel ID"。如果不改動(dòng)，將代表默認(rèn)渠道。

渠道ID

請參考第5節(jié)如何上傳APK。

3.3 添加Service和Activity到標(biāo)簽下： （請注意：v2.4的SDK中，對話框改為Activity實(shí)現(xiàn)）

注意

com.umeng包名可能有變，如果不能下載，請檢查包名，替換成正確的包名。

<service
    android:name="com.umeng.update.net.DownloadingService"
    android:process=":DownloadingService" >
service>
<activity 
    android:name="com.umeng.update.UpdateDialogActivity"
    android:theme="@android:style/Theme.Translucent.NoTitleBar" >
activity>

4. 調(diào)用更新接口

主要應(yīng)用場景：最常見的自動(dòng)更新模式，當(dāng)用戶進(jìn)入應(yīng)用首頁后，如果處于wifi環(huán)境則檢測更新，如果有更新，彈出對話框提示有新版本，用戶點(diǎn)選更新開始下載更新。
在應(yīng)用程序入口Activity里的OnCreate() 方法中調(diào)用

public void onCreate(Bundle  savedInstanceState) {
    super.onCreate(savedInstanceState);
    UmengUpdateAgent.update(this);

注意

考慮到用戶流量的限制，目前我們默認(rèn)在Wi-Fi接入情況下才進(jìn)行自動(dòng)提醒。如需要在任意網(wǎng)絡(luò)環(huán)境下都進(jìn)行更新自動(dòng)提醒，則請?jiān)?code>update調(diào)用之前添加以下代碼：UmengUpdateAgent.setUpdateOnlyWifi(false)。 特別提示：針對機(jī)頂盒等可能不支持或者沒有無線網(wǎng)絡(luò)的設(shè)備， 請同樣添加上述代碼。

API：

public static void update(Context context)

v2.4版本之后的SDK中，您可以傳入當(dāng)前Activity的Context，也可以傳入Application的Context。

5. 上傳最新的APK

如果開發(fā)者已經(jīng)有了最新的APK版本，只要上傳到友盟網(wǎng)站，同時(shí)客戶端版本的版本號(hào)（VersionCode）小于上傳的最新版本，客戶端在啟動(dòng)時(shí)就會(huì)有更新提示。
上傳位置：登錄友盟開發(fā)者后臺(tái)，在左上角選擇應(yīng)用后，右邊可以看到統(tǒng)計(jì)分析、組件、管理三部分。點(diǎn)擊組件，左側(cè)就會(huì)出現(xiàn)自動(dòng)更新條目。請點(diǎn)擊進(jìn)入，即可找到上傳的入口。

注意

上傳APK前，請檢查其VersionCode是否大于舊版本的。 新版本與老版本的簽名要保持一致，否則安卓系統(tǒng)將會(huì)提示安裝失敗，無法升級(jí)。

如果需要按渠道更新，需要集成友盟統(tǒng)計(jì)SDK，在設(shè)置了上述3.2中的渠道ID之后，才能夠在“統(tǒng)計(jì)分析”-“管理”-“渠道”中看到對應(yīng)的渠道ID，然后才能在自動(dòng)更新服務(wù)中使用。

6. 集成檢測

v2.4版本以后的SDK中默認(rèn)開啟了集成檢測功能，在調(diào)用任意的更新接口后，我們將替您自動(dòng)檢查上述集成過程中2、3兩個(gè)步驟是否被正確完成。 如果正確完成不會(huì)出現(xiàn)任何提示，否則會(huì)以如下的toast提示您。
你可以通過調(diào)用UmengUpdateAgent.setUpdateCheckConfig(false)來禁用此功能。

toast的含義如下：

"Please copy all resources (res/) from SDK to your project!"：請檢查是不是把res文件夾下所有的資源文件都放到了工程中。
"Please add Permission in AndroidManifest!"：請檢查上述步驟3.1中的相關(guān)權(quán)限是否正確添加。
"Please add Activity in AndroidManifest!"：請檢查上述步驟3.3中的Activity是否正確添加。
"Please add Service in AndroidManifest!"：請檢查上述步驟3.3中的Service是否正確添加。
"Please set umeng appkey!"：請檢查上述步驟3.2中的APPKEY是否正確添加。

在完成上面的步驟之后，在您的終端上啟動(dòng)應(yīng)用，就可以看到彈出的自動(dòng)更新提示對話框。

7.集成幫助

1.常見問題

一、如何在代碼中決定用增量更新還是全量更新？

調(diào)用setDeltaUpdate(boolean deltaUpdate)設(shè)置，默認(rèn)true，設(shè)為false則為全量更新。

二、手機(jī)連接到WiFi網(wǎng)絡(luò)， 更新提示"非WiFi"環(huán)境？

請?zhí)砑泳W(wǎng)絡(luò)狀態(tài)檢查所需權(quán)限：android.permission.ACCESS_NETWORK_STATE

三、自動(dòng)更新為什么在3G情況下沒有提示更新？

我們默認(rèn)設(shè)置是只在wifi網(wǎng)絡(luò)下彈出更新，如果需要在非wifi下有更新提示請?jiān)诔绦蛉肟谔砑尤缦麓a：UmengUpdateAgent.setUpdateOnlyWifi(false)

四、自動(dòng)更新 apk是在哪里上傳的？查看幫助

五、自動(dòng)更新混淆后無法使用怎么辦？查看幫助

六、使用增量更新時(shí)，只有arm的so文件，怎樣支持x86和mips？查看幫助

更多常見問題請點(diǎn)擊訪問：友盟自動(dòng)更新常見問題索引

2.技術(shù)支持

如果還有任何問題，請把您的問題發(fā)郵件至msg-support@umeng.com或者聯(lián)系企業(yè)QQ:800083942，另外還可以添加我們友盟自動(dòng)更新官方QQ群：154857575，同時(shí)您也可以把您的問題發(fā)到友盟開發(fā)者社區(qū)，我們會(huì)盡快回復(fù)您。

如果可以附上相關(guān)日志，我們可以更好的幫助您解決問題，可以通過加入這句代碼UpdateConfig.setDebug(true);來打開日志輸出，發(fā)布應(yīng)用時(shí)請去掉。