APICloud开源框架使用指南

APICloud开源框架是使用机智云SDK开发的APP模板，实现了SDK的加载、初始化、用户注册、登陆、设备配置、设备发现、设备连接等基本的功能。APP开发者可以基于框架实现具体产品的控制界面就可以生成一个完整的APP。目前提供iOS、Android和APICloud三个版本的开源框架，APICloud版的主要优势是一套代码适配iOS和Android两个平台。
本文档主要目的是告诉开发者如何利用开源框架来快速开发一个完整的APP，当然，也可以将源码作为参考，重新开发一套APP。
APICloud开源框架工程源码链接：https://github.com/gizwits/GizOpenSourceAppKit_APICloud
APICloud Gokit App是使用开源框架工程的源码范例，源码链接：https://github.com/gizwits/gokit_demo_in_apicloud

APICloud开发类似于Web前端开发，也是通过CSS + html + Javascript来完成的，目录也是基于此结构来区分的，如下图：

具体到每个文件的功能描述如下：

在APICloud中每一个应用都有一个唯一的id标识，开源框架中并没有该id，需要重新创建一个APICloud项目，获取项目id，才能运行框架源码。

右击《我的APP项目》栏下的空白部分，点击新建APICloud项目；或者点击菜单栏的导航按钮，点击《新建APP项目》，进入项目创建页面。

选择《空白应用》，点击《完成》，此时，APICloud也同步生成了一个空白项目。

进入APICloud的开发控制台：，可以看到创建成功的APP项目

上面生成的空白源码目录如下，将红框部分的文件删除。

下图是框架的源码，将红框部分的文件复制到上图空白源码部分，则新创建的源码除了config.xml之外都与框架相同了。

config.xml是APICloud提供的配置文件，在每个项目中都会存在一个config.xml，上面提供了项目的id，也就是项目在APICloud平台的唯一标识，开发者个人的账号信息，以及一些界面的设置、项目所使用到的第三方模块的引入。若想了解详细内容可查看：。
下图是框架的config.xml文件内容，将红框部分的内容，替换为新建项目生成的对应值，然后将新建项目的config.xml文件替换为该config.xml文件

如果项目中使用QQ登陆，需要前往腾讯开发者中心申请应用，并获取apiKey值，urlScheme的value值就是填写 tencent+apiKey的字符串值； apikey的value值直接填写QQ的apikey值即可。
将项目的改动提交到APICloud云端，如下：

将源码移植与Config.xml的改动提交到云端后，APICloud会根据源码使用到的模块自动导入相应
的模块，机智云SDK需要手动导入。

搜索并导入GizWifiSDK

此时的源码还需要设置安卓和iOS应用的appid和appsecret，并且设置在机智云官网创建的产品的ProductKey。
在机智云官网获取产品的ProductKey和ProductSecret。

获取安卓和iOS的AppID和AppSecret

进入框架的index.html页面：

将红框中的代码修改为下图红框所示：