GizOpenSource_AppKit_Android機(jī)智云app源碼（安卓版本開源框架）

機(jī)智云APP開源框架的源碼可快速開發(fā)配套app（目前提供ios、Andriod版本），不僅無縫的支持設(shè)備到設(shè)備的互聯(lián)，還能完成不同類型的消息推送，如：郵件推送、短信推送、百度推送和極光推送。

此為Eclipse版本。

Android Studio版本下載地址：https://github.com/gizwits/GOpenSource_AppKit_Android_AS

介紹

機(jī)智云開源框架（GizOpenSource_AppKit_Android） 是開源的適用于物聯(lián)網(wǎng)的軟件框架，用于無縫的支持設(shè)備到設(shè)備的互聯(lián)。

能幫助開發(fā)者快速構(gòu)建物聯(lián)網(wǎng)生態(tài)系統(tǒng)，實(shí)現(xiàn)設(shè)備間互聯(lián)，加速智能設(shè)備的應(yīng)用開發(fā)。其包含Wi-Fi類智能硬件app通用功能的一套源碼。

只要是使用機(jī)智云協(xié)議的產(chǎn)品，開發(fā)者開發(fā)配套的app時(shí)都可以直接使用該框架的源碼實(shí)現(xiàn)快速開發(fā)，從而縮短app的開發(fā)周期短、降低開發(fā)成本。

請注意：

使用機(jī)智云物聯(lián)網(wǎng)開源APP之前，需要先在機(jī)智云開發(fā)平臺(tái)創(chuàng)建您自己的產(chǎn)品和應(yīng)用。

開源App需要使用您申請的AppId、AppSecret以及您自己的產(chǎn)品ProductKey才能正常運(yùn)行。具體申請流程請參見：http://docs.gizwits.com/hc/。

開源框架工程可通過修改配置文件配置開發(fā)者的個(gè)人應(yīng)用信息，請參考使用說明中的 第5節(jié) 配置文件說明 進(jìn)行替換。

使用QQ、微信登錄或百度或極光推送功能之前，需要您先到相應(yīng)網(wǎng)站申請對應(yīng)的應(yīng)用信息，在配置文件中作相應(yīng)的替換。

GizWifiSDK 版本號

2.05.05.21618

目錄結(jié)構(gòu)說明：

> libs：包括 GizWifiSDK 在內(nèi)的的第三方庫目錄

> assets: 包含 UIConfig.json 配置文件

> GizOpenSourceModules：組成模塊

>> GosApplication.java // SDK 在此啟動(dòng)

>> CommonModule // 公共方法類、資源文件讀取類 

>> ConfigModule // 設(shè)備配置模塊，包含 AirLink 及 SoftAP

>> UserModule // 用戶模塊，包含 用戶登錄、用戶注冊、找回密碼

>> DeviceModule // 設(shè)備模塊，包含 設(shè)備列表

>> ControlModule // 控制模塊，包含 控制示例

>> SettingsModule // 設(shè)置模塊，包含 設(shè)置菜單 及其 包含的子菜單項(xiàng)（關(guān)于等）

>> PushModule // 推送模塊，包含 百度和極光的推送SDK 集成封裝

>> ThirdAccountModule // 第三方登錄模塊， 包含 第三方登錄（QQ、微信等）

>> view // 自定義控件

>> utils // 工具類

>> wxapi // 微信集成包

>> zxing // 掃描二維碼

使用說明：

1. 默認(rèn)程序入口

默認(rèn)程序入口在 UserModule 中的 GosUserLoginActivity。

2. 更改啟動(dòng)后的載入界面

如果要啟動(dòng)程序直接進(jìn)入設(shè)備列表，可在 AndroidManifest.xml 文件中將 GosUserLoginActivity 的屬性調(diào)整到 GosDeviceListActivity 中：

3. 加載控制界面

代碼位于 GosDeviceListActivity 文件中的 handleMessage 方法 case TOCONTROL 中:

                    case TOCONTROL:
                        intent = new Intent(GosDeviceListActivity.this, GosDeviceControlActivity.class);
                        Bundle bundle = new Bundle();
                        bundle.putParcelable("GizWifiDevice", (GizWifiDevice) msg.obj);
                        intent.putExtras(bundle);
                        startActivity(intent);
                    break;

修改 GosDeviceControlActivity 類為開發(fā)者自己編寫的控制界面的類即可。

4. 設(shè)置界面

設(shè)置界面位于 SettingsModule 中的 GosSettiingsActivity，在 activity_gos_settings.xml 文件中添加相應(yīng)布局后，再回到 GosSettiingsActivity 中實(shí)現(xiàn)交互事件即可：

                    @Override
                    public void onClick(View v) {
                        switch (v.getId()) {
                        case R.id.llAbout:
                            intent = new Intent(GosSettiingsActivity.this, GosAboutActivity.class);
                            startActivity(intent);
                            break;

                        default:
                            break;
                        }

                    }

5. 配置文件說明

配置文件位置：assets/UIConfig.json

配置文件可對程序樣式及機(jī)智云appid等進(jìn)行配置。

可配置參數(shù)有：

app_id：機(jī)智云 app id
app_secret：機(jī)智云 app secret
product_key：機(jī)智云 product key
wifi_type_select：默認(rèn)配置模塊wifi模組選擇功能是否開啟
tencent_app_id：qq登錄 app id
wechat_app_id：微信登錄 app id
wechat_app_secret：微信登錄 app secret
push_type：推送類型 【0：關(guān)閉，1：極光，2：百度】
bpush_app_key：百度推送 app key
openAPIDomain：openAPI 域名及端口，格式：api.gizwits.com”。要指定端口，格式為：”xxx.xxxxxxx.com:81&8443”
siteDomain：site 域名及端口，格式：“site.gizwits.com”。要指定端口，格式為：”xxx.xxxxxxx.com:81&8443”
pushDomain：推送綁定服務(wù)器 域名及端口，格式：“push.gizwits.com”。要指定端口，格式為：”xxx.xxxxxxx.com:81&8443”
buttonColor：按鈕顏色
buttonTextColor：按鈕文字顏色
navigationBarColor：導(dǎo)航欄顏色
navigationBarTextColor：導(dǎo)航欄文字顏色
configProgressViewColor：配置中界面 progress view 顏色
addDeviceTitle：添加設(shè)備界面 導(dǎo)航欄標(biāo)題文字
qq：是否打開QQ登錄【true：打開】
wechat：是否打開微信登錄【true：打開】
anonymousLogin：是否打開匿名登錄【true：打開】

          需要注意:
          1.極光推送的appid需要在AndroidManifest.xml 中填寫見243行。
          2.微信登錄需要進(jìn)行在騰訊api中設(shè)置自己的md5值否者無法正常運(yùn)行
          3.tencent_app_id需要在AndroidManifest.xml中89行填寫

具體細(xì)節(jié)可以參考【開源框架工程使用文檔】：http://docs.gizwits.com/hc/kb/article/186638/

程序調(diào)試

您可以使用虛擬設(shè)備或者實(shí)體智能設(shè)備搭建調(diào)試環(huán)境。

? 虛擬設(shè)備
    機(jī)智云官網(wǎng)提供GoKit虛擬設(shè)備的支持，鏈接地址：
http://dev.gizwits.com/zh-cn/developer/product/

? 實(shí)體設(shè)備
    GoKit開發(fā)板。您可以在機(jī)智云官方網(wǎng)站上免費(fèi)預(yù)約申請，申請地址：
    http://www.gizwits.com/zh-cn/gokit

GoKit開發(fā)板提供MCU開源代碼供智能硬件設(shè)計(jì)者參考，請去此處下載：https://github.com/gizwits/gokit-mcu

問題反饋

您可以給機(jī)智云的技術(shù)支持人員發(fā)送郵件，反饋您在使用過程中遇到的任何問題。
郵箱：[email protected]