检查更新SDK 集成指南

如果您在集成过程中遇到任何问题，都可以邮件至developer@xiaomi.com ，我们会尽快答复您

小米应用商店检查更新SDK(下文简写为『检查更新SDK』)帮助您的用户尽快获得最新版本的应用！轻松增加『自动检查更新』功能，通过小米应用商店的CDN服务，快速的把最新版应用推送给用户！

功能特点：

  • 支持增量更新：检查更新SDK会自动识别用户版本，并提供diff包给用户，加速省流
  • 一次发布全面更新：只要在小米应用商店发布新版，所有的用户都可以收到新版发布提醒。
  • 标准Android SDK：无论用户是否使用MIUI，都可以收到更新提醒。
  • 方便省心：无需考虑配置服务器，部署CDN等问题，小米应用商店免费提供。
  • 支持基于设备属性和API-Level的系统版本过滤，会将新版推送给支持的设备。
  • 独家支持：在MIUI系统上支持调用系统商店更新，升级成功率更高！

立即开始集成：

点此下载SDK包 ( 2013年12月11日更新 内附集成文档 )

1. 在工程中加入检查更新SDK

添加jar包

下载最新版SDK的zip包并解压缩，将其中的libs 文件夹合并到本地工程libs子目录下。
Eclipse用户右键工程根目录，选择Properties -> Java Build Path -> Libraries，然后点击Add External JARs... 选择指向xiaomi_sdk.jar的路径，点击OK，即导入成功。

添加资源文件

将SDK提供的res文件夹拷入工程目录下, 和工程本身res目录合并。
请注意: 小米SDK提供的资源文件都以xiaomi_开头。

2. 在AndroidManifest.xml文件中添加SDK信息

添加检查更新需要的权限

打开AndroidManifest.xml，添加SDK需要的权限到<manifest>标签下：
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="com.xiaomi.market.sdk.UPDATE" />

添加Receiver

<receiver android:name="com.xiaomi.market.sdk.DownloadCompleteReceiver" >
<intent-filter>
<action android:name="android.intent.action.DOWNLOAD_COMPLETE" />
</intent-filter>
</receiver>

说明：SDK调用系统下载管理器进行下载，需要注册receiver，在下载完成后进行增量包合成与安装

3. 集成SDK代码

在应用程序入口Activity里的OnCreate() 方法中调用

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

API：

- public void update(Context context)

Done! 集成成功!

现在只要在小米应用商店发布应用，您的用户就会收到更新提醒了！

Tips:

  1. 新版本App要在小米应用商店上架之后，才能检查到更新
  2. 考虑到集成检查更新SDK的版本分发也需要时间，建议您尽早集成

常见问题 FAQ：