企业App Store开发指南

本文档分为四部分：

第一部分介绍创建和配置App Store应用。
第二部分针对于开发者，帮助开发者了解这个项目，从而熟悉代码进行二次开发。
第三部分写给后台管理者的，帮助管理者了解平台的使用方法。
第四部分是App Store的接口文档，详细展示了返回的数据列表。

App Store应用是一个应用管理的APP，与创建普通应用不同的是，创建后会开放控制台权限，即在企业服务中，会有一个应用管理的后台，可以对应用和权限进行管理。

企业App Store开发指南 - 图1

在首页创建应用

选择APPStore，进行创建

企业App Store开发指南 - 图2

在应用信息中记录应用ID和appKey

修改代码配置文件

用Studio2将代码同步到本地，将res路径下的key.xml中appKey和appId修改为刚才创建的id和appKey，host修改为云服务器的地址
Studio2使用教程参考：

企业App Store开发指南 - 图3

如有需要，可以在script路径中修改service.js中的云端数据库的名称，保证与云端数据库中的表名相同。

编译应用

提交代码，进行云编译。

为了方便开发者更快的熟悉本项目，能够很好的熟悉代码逻辑和对项目进行二次开发，本文档将按照物理文件进行分析，从而制定本文档。文档中会大致讲解项目主体思想，细节还是需要开发者自行理解。

App Store 项目概述

该项目代码层面的功能主要有全局( appkey、appid、host等 )字段的获取、子应用下载、子应用更新、子应用解压、子应用命名、打开子应用、删除子应用、展示子应用等功能。

企业App Store开发指南 - 图4

index.html

根目录中的index.html是项目的入口文件，该页面只是做了基本的布局显示,没有什么逻辑。布局它包括首页头部布局、$api.fixStatusBar 兼容沉浸式、全局值 appkey、appid、host 获取、开启main.html页面、双击返回退出应用等。

html路径

main.html

这个文件是index.html通过api.openFrame()方法启动的。

初始化了APP信息，通过getDefaulItems()方法获取后台配置的应用信息，并且创建本地数据库，存到本地作为缓存。注意，getDefaulItems()方法只有在第一次应用安装后启动的时候才会从网络获取应用列表，第二次直接从本地数据库中读取数据。
初始化banner图，从网络数据库获取banner表中的数据，如果banner表中没有数据，则默认显示一张默认图片，有数据的话从数据库读取网络图片进行展示。
通过isNative字段来判断应用类型来打开不同的应用。(0:平台应用，1:原生应用，2:H5应用)
注册监听事件，每当数据改变的时候，通过发送时间refreshHomeApps刷新APP列表。

edit-app-win.html

这个文件是index.html右上角编辑按钮通过api.openWin()方法启动的。只是初始化了头部布局，打开子页面frame。

edit-app-frame.html

这个文件是edit.html通过api.openFrame()方法启动的。

initSortable()初始化拖动组件，设置监听Touch事件，来实现排序功能。
removeItem()方法是用来移除一个APP的
如果数据发生变动，返回到首页的时候会把新数据保存到数据库中，如果没有变化，则不保存，直接返回。

install-app-win.html

install-app-all-frame.html

这个是全部应用的frame

通过filterAppStatus()来过滤应用的安装更新状态。
判断不同应用类型来下载、安装、打开应用，可参考代码注释理解。

install-app-add-frame.html

这个是添加应用的frame

通过getAppsList()方法获取网络数据库中的应用列表，实现了分页加载，一页10条数据，可以通过修改itemNum来自定义每页展示APP数量。
通过filterInstallApp()来过滤首页已经展示的应用。
判断不同应用类型来下载、安装、打开应用，可参考代码注释理解。

install-app-update-frame.html

这个是更新应用的frame

通过getApps()方法来获取应用更新，安装、下载、启动请参考代码及注释。
操作后，对首页中的数量提示进行修改。

search-win.html

这个是搜索页面，通过应用管理右上角的搜索图标进入的，初始化页面页头，通过api.openFrame打开frame页面。

search-frame.html

这个页面展示了搜索的结果。

通过getAppsList()方法获取网络数据库中的应用列表。
通过filterAppStatus()来过滤首页已经展示的应用。
判断不同应用类型来下载、安装、打开应用，可参考代码注释理解。

h5.html

这个页面是为了打开H5应用的Win，直接通过api.openFrame()来启动H5应用的。

script路径

service.js

定义了各种开发时可能需要用到的参数，以及对数据库操作的封装，其中包括预定义参数、UI类 API、辅助类 API、业务逻辑操作API，开发者只需要根据自己的需求调用对应的方法即可，也可以自定义方法，添加到该文件的下方。

doT.min.js

精巧快速的JavaScript模板引擎更多使用介绍参考：doT使用文档

Sortable.js

拖动组件，具体使用方法参考官方文档。

common.js

这里面整合了平台应用、原生应用的启动更新等公共方法，可以在任意界面进入使用。

res路径

key.xml

企业App Store开发指南 - 图5

appKey 为创建的应用的应用appKey
appId 为应用下方的ID值
host 云服务器根路径，这里填写服务器地址

功能模块图

模块介绍

创建App Store应用的时候默认添加下述8个模块，推荐开发者在开发过程中添加常用的模块到App Store中，来支持打开平台应用中引用的模块，避免平台应用中使用到的模块在App Store中没有而不能使用的问题。

arcProgress模块

arcProgress是一个弧形进度条，包括环形、扇形、类月牙形三种样式，开发者可以自定义进度色和背景色。此模块动画流畅，原生实现效果炫酷，有效的解决了网页画圆会有锯齿的问题更多使用参考：arcProgress详细使用文档

UIPullRefreshFlash模块

UIPullRefreshFlash 模块对引擎新推出的下拉刷新接口进行了一层封装，App 可以通过此模块来实现带炫酷动画效果的下拉刷新功能。使用此模块，在用户下拉时本模块会随用户下拉高度而放大缩小下拉出的提示图标，同时会随用户下拉高度播放一组关键帧图片，该图片数组是通过 api.setCustomRefreshHeaderInfo 接口以图片数组的形式传给模块的，每下拉一定距离（阈值/图片数量），播放一帧图片；当下拉高度达到一定阈值后触发加载事件：进入加载状态时，刷新提示图标开始播放加载关键帧图片数组，此时图片每帧间隔为 50 毫秒，同时将下拉刷新事件回发给前端。前端得到下拉刷新事件后开始加载数据；数据加载完毕，调用接口 api.refreshHeaderLoadDone 以停止加载状态。更多使用参考：