米家app最新版本：5.1 25

米家APP最新API Level：61

米家APP compileSdkVersion：27

米家APP minSdkVersion：15

米家APP targetSdkVersion：19

文檔修改日期：2018-4-4

本文檔描述了米家擴展程序Android客戶端的申請、創建、開發、調試的流程，更多內容詳見下列文檔，遇到問題先查看 Wikigen_plug.py

MiJiaAuthSDK提供米家Auth授權SDK

mibtservice

common_ui封裝了一些通用的米家UI組件，米家擴展程序可以使用( 擴展程序工程可通過plug。gradle腳本添加引用，不需要直接引用)

libs_ex提供了一些通用的第三方sdk，比如appcompat-v7、support-v4、support-v13、recyclerview、微信sdk等，米家擴展程序開發的時候不需要在自己的工程中重複引用這些第三方sdk( 擴展程序工程可通過plug。gradle腳本添加引用，不需要直接引用)

pluglib封裝了米家APP提供給擴展程序的各種api( 擴展程序工程可通過plug。gradle腳本添加引用，不需要直接引用)

plugProject

plug.gradleapply from:"${project.rootDir.absolutePath}/plug.gradle"

SmartHome.apk

md_imageAPI開發文檔詳細描述了米家擴展程序開發中可以使用哪些米家APP提供的APIEmptyDemo

xiaomi_bledemov2演示了藍牙鎖相關API

PluginDemo演示了給米家擴展程序提供的大部分UI組件以及相關功能API

說明：必須得使用米家APP測試賬號才能運行示例米家擴展程序，測試賬號如下：用戶名:923522198，密碼:123asdzxc

安裝工程根目錄下的smarthome。apk

應用商店版本米家app是沒有辦法調試米家擴展程序的，只能安裝工程根目錄下單獨提供的smarthome。apk

打開米家APP，登錄如下測試賬號：用戶名:923522198，密碼:123asdzxc

3)同步Gradle

1)通過AndroidStudio直接Run

PluginDemo為米家擴展程序工程名

./gradlew installPluginDemoDebug 安裝運行debug配置米家擴展程序

./gradlew installPluginDemoRelease 安裝運行release米家擴展程序

申請開發者賬號developerId

登記新產品，記錄設備model

簽名文件的md5信息獲取，需要去掉:號

keytool -list -v -keystore keyFilePath -storepass keypassword -keypass keypassword

1)使用上述申請developerId的賬號登錄小米IoT開放平台

如果開發者如果不是用註冊開發者的小米賬號登錄的話，需要把當前的小米賬號配置成協作開發或者測試白名單：

安裝開發版米家APP

米家擴展程序工程放置於plugProject目錄下，如下圖，可以放置多個米家擴展程序工程：

python gen_plug.py model developerId packageName

通過gen_plug。py腳本生成新的米家擴展程序工程時，會在keystore目錄下生成一個示例的key。keystore，這個只是作為示例使用，為了安全，實際擴展程序開發中需要替換成自己的簽名文件。defaultConfig {

//minSdkVersion和targetSdkVersion必須與米家APP保持一致，如果minSdkVersion設置過高，則米家擴展程序無法在低版本Android平台下載安裝

minSdkVersion 15

targetSdkVersion 19

}

signingConfigs {

release {

storeFile new File("${project.projectDir}/keystore/key.keystore")

storePassword 'mihome'

keyAlias 'mihome-demo-key'

keyPassword 'mihome'

}

}

buildTypes {

debug {

debuggable true

signingConfig signingConfigs.release

}

release {

minifyEnabled true

shrinkResources false

zipAlignEnabled true

proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'

signingConfig signingConfigs.release

}

}apply from:"${project.rootDir.absolutePath}/plug.gradle"project.ext.set("complieProject",[":demolib"])

再次說明下：必須在米家APP中已經了添加了某個設備后，才能調試運行這個設備的米家擴展程序，不然沒法調試運行米家擴展程序。

米家擴展程序開發完成，測試通過後，可以到米家後台申請上線，編譯好的安裝包在對應米家擴展程序工程/build/outputs/apk下面。

在米家擴展程序的測試和發布過程中如有其它疑問可聯繫米家的工作人員。

1)英文資源放到/res/values下；

2)中文資源放到/res/values-zh/下。

更多其它問題可查看 Wiki