GizOpenSource_AppKit_iOS機智云app源碼（ios框架）

這是機智云開源的 ios 版本物聯(lián)網APP框架。開源框架已實現(xiàn)用戶登錄注冊、設備配置、訂閱等功能

andriod版本的開源框架見：https://github.com/gizwits/GizOpenSource_AppKit_Android

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

開源APP需要使用您申請的AppId、AppSecret以及您自己的產品ProductKey才能正常運行。

具體申請流程請參見：http://docs.gizwits.com/hc/

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

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

GizWifiSDK 版本號

2.05.05.21618

功能介紹

本文檔為機智云物聯(lián)網開源基礎App套件使用說明，旨在為機智云物聯(lián)網開發(fā)者提供一個快速開發(fā)模板，可在此工程基礎上快速開發(fā)智能設備App，或參考這里的相關代碼進行開發(fā)。

目錄結構說明

> Lib：包括 GizWifiSDK 在內的的第三方庫目錄

> GizOpenSourceModules：組成模塊

>> CommonModule // 公共方法類、資源文件 及 自定義 Cell

>> ConfigModule // 設備配置模塊，包含 AirLink 及 SoftAP

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

>> DeviceModule // 設備模塊，包含 設備列表

>> SettingsModule // 設置模塊，包含 設置菜單 及其 包含的子菜單項（關于等）

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

使用說明

1. 默認程序入口

默認程序入口在 UserModule 中的 LoginViewController。

2. 更改啟動后的載入界面

如果要啟動程序直接進入設備列表，可在 LoginViewController.m 文件的 “- (void)viewDidLoad” 方法中打開最后一行代碼的注釋:

[self toDeviceListWithoutLogin:nil]

3. 加載控制界面

代碼位于 AppDelegate.m 文件中的 didFinishLaunchingWithOptions 方法第一行:

[GosCommon sharedInstance].controlHandler = ^(GizWifiDevice device, UIViewController deviceListController) {
    GosDeviceController *devCtrl = [[GosDeviceController alloc] initWithDevice:device];
    [deviceListController.navigationController pushViewController:devCtrl animated:YES];
};

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

4. 設置界面

設置界面位于 SettingsModule 中的 GosSettingsViewController，按照 UITableView 實現(xiàn)官方的委托代理方法即可。

5. 配置文件說明

配置文件位置：GOpenSourceModules/CommonModule/UIConfig.json

配置文件可對程序樣式及機智云appid等進行配置。

可配置參數(shù)有：

app_id：機智云 app id
app_secret：機智云 app secret
product_key：機智云 product key
wifi_type_select：默認配置模塊wifi模組選擇功能是否開啟
tencent_app_id：qq登錄 app id
wechat_app_id：微信登錄 app id
wechat_app_secret：微信登錄 app secret
push_type：推送類型 【0：關閉，1：極光，2：百度】
jpush_app_key：極光推送 app key
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：推送綁定服務器 域名及端口，格式：“push.gizwits.com”。要指定端口，格式為：”xxx.xxxxxxx.com:81&8443”
buttonColor：按鈕顏色
buttonTextColor：按鈕文字顏色
navigationBarColor：導航欄顏色
navigationBarTextColor：導航欄文字顏色
configProgressViewColor：配置中界面 progress view 顏色
statusBarStyle：狀態(tài)文字欄顏色 【0：黑色，1：白色】
addDeviceTitle：添加設備界面 導航欄標題文字
qq：是否打開QQ登錄【true：打開】
wechat：是否打開微信登錄【true：打開】
anonymousLogin：是否打開匿名登錄【true：打開】

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

6. 第三方賬號登錄的使用

使用微信、QQ登錄功能，需要在info.plist設置URLScheme，登錄完成后可從第三方應用跳回此應用

使用QQ，把tencentxxx中的"xxx"換成UIConfig.json中對應的"tencent_app_id"字段的值
使用微信，把"xxx"換成UIConfig.json中對應的"wechat_app_id"字段的值

程序調試

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

? 虛擬設備
    機智云官網提供GoKit虛擬設備的支持，鏈接地址：
http://dev.gizwits.com/zh-cn/developer/product/

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

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

問題反饋

您可以給機智云的技術支持人員發(fā)送郵件，反饋您在使用過程中遇到的任何問題。
郵箱：[email protected]
網站：www.gizwits.com
技術社區(qū)：http://club.gizwits.com/forum.php