友盟自动更新

1.1   导入SDK所需jar包

下载最新版SDK的zip包，将其中的libs文件夹合并到本地工程libs子目录下。

Eclipse用户右键工程根目录，选择Properties -> Java Build Path -> Libraries，然后点击Add External JARs... 选择指向jar的路径，点击OK，即导入成功。

注意

Eclipse ADT 17 以上版本用户，不要通过上述步骤手动添加jar包引用。请在工程目录下建一个文件夹libs，把jar包直接拷贝到这个文件夹下，再在Eclipse里面刷新一下工程就好了。详情请参考Dealing with dependencies in Android projects.

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

1.2   添加资源文件

将SDK提供的res文件夹拷入工程目录下, 和工程本身res目录合并。请不要随便删除其中的文件。

提示

友盟SDK提供的资源文件都以umeng_开头。

1.3   配置AndroidManifest.xml

3.1 打开AndroidManifest.xml，添加SDK需要的权限到<manifest>标签下：

<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 权限允许将下载的apk保存到sd卡中。
android.permission.ACCESS_NETWORK_STATE 权限允许检查网络状态，从而根据不同网络环境决定何种下载策略,务必添加该权限。

3.2 添加APPKEY和渠道到<application>标签下： （如果已经集成了统计SDK等友盟其他服务，不需要重复添加APPKEY）

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

UMENG_APPKEY：用来定位该应用的唯一性，用您该应用的UMENG APPKEY，替换value中的"YOUR APP KEY"。
UMENG_CHANNEL：用来标注应用推广渠道，不同渠道可以上传不同更新包，您可以使用20位以内的英文和数字为渠道定名，替换value中的"Channel ID"。如果不改动，将代表默认渠道。（特别提示：如果需要使用友盟自动更新多渠道更新，必须先集成友盟统计SDK）

渠道ID

请参考第5节如何上传APK。

3.3 添加Service和Activity到<application>标签下： （请注意：v2.4的SDK中，对话框改为Activity实现）

注意

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>

1.4   调用更新接口

主要应用场景：最常见的自动更新模式，当用户进入应用首页后，如果处于wifi环境则检测更新，如果有更新，弹出对话框提示有新版本，用户点选更新开始下载更新。
在应用程序入口Activity里的OnCreate() 方法中调用

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

注意

考虑到用户流量的限制，目前我们默认在Wi-Fi接入情况下才进行自动提醒。如需要在任意网络环境下都进行更新自动提醒，则请在update调用之前添加以下代码：UmengUpdateAgent.setUpdateOnlyWifi(false)。 特别提示：针对机顶盒等可能不支持或者没有无线网络的设备， 请同样添加上述代码。

手动更新

protected Context mContext;
case menu1:
            Toast.makeText(mContext, "正在检查。。。", Toast.LENGTH_SHORT).show();
            UmengUpdateAgent.setUpdateAutoPopup(false);
            UmengUpdateAgent.setUpdateListener(new UmengUpdateListener()
            {

                @Override
                public void onUpdateReturned(int updateStatus, UpdateResponse updateInfo)
                {
                    // TODO Auto-generated method stub
                    switch (updateStatus)
                    {
                    case UpdateStatus.Yes: // has update
                        UmengUpdateAgent.showUpdateDialog(mContext, updateInfo);
                        break;
                    case UpdateStatus.No: // has no update
                        Toast.makeText(mContext, "没有更新", Toast.LENGTH_SHORT).show();
                        break;
                    case UpdateStatus.NoneWifi: // none wifi
                        Toast.makeText(mContext, "没有wifi连接， 只在wifi下更新", Toast.LENGTH_SHORT).show();
                        break;
                    case UpdateStatus.Timeout: // time out
                        Toast.makeText(mContext, "请检查网络", Toast.LENGTH_SHORT).show();
                        break;
                    }
                }
            });
            UmengUpdateAgent.forceUpdate(mContext);
            break;