1.1 导入SDK所需jar包
下载最新版SDK的zip包,将其中的libs
文件夹合并到本地工程libs
子目录下。
Eclipse
用户右键工程根目录,选择Properties -> Java Build Path -> Libraries
,然后点击Add External JARs...
选择指向jar的路径,点击OK
,即导入成功。
注意
Eclipse ADT 17 以上版本用户,不要通过上述步骤手动添加jar包引用。请在工程目录下建一个文件夹
libs目录下的libs
,把jar包直接拷贝到这个文件夹下,再在Eclipse里面刷新一下工程就好了。详情请参考.libs/armeabi/libbspatch.so
文件是用于支持增量更新功能的库文件,也需要在eclipse中添加。
1.2 添加资源文件
将SDK提供的res
文件夹拷入工程目录下, 和工程本身res
目录合并。请不要随便删除其中的文件。
提示
友盟SDK提供的资源文件都以
umeng_
开头。
1.3 配置AndroidManifest.xml
3.1 打开AndroidManifest.xml
,添加SDK需要的权限到<manifest>
标签下:
android.permission.WRITE_EXTERNAL_STORAGE
权限允许将下载的apk保存到sd卡中。
android.permission.ACCESS_NETWORK_STATE
权限允许检查网络状态,从而根据不同网络环境决定何种下载策略,务必添加该权限。 3.2 添加APPKEY和渠道到<application>
标签下: (如果已经集成了统计SDK等友盟其他服务,不需要重复添加APPKEY)
UMENG_APPKEY:用来定位该应用的唯一性,用您该应用的UMENG APPKEY,替换value中的"YOUR APP KEY"。
UMENG_CHANNEL:用来标注应用推广渠道,不同渠道可以上传不同更新包,您可以使用20位以内的英文和数字为渠道定名,替换value中的"Channel ID"。如果不改动,将代表默认渠道。(特别提示:如果需要使用友盟自动更新多渠道更新,必须先集成)
渠道ID
请参考第5节如何上传APK。
3.3 添加Service和Activity到<application>
标签下: (请注意:v2.4的SDK中,对话框改为Activity实现)
注意
com.umeng包名可能有变,如果不能下载,请检查包名,替换成正确的包名。
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;