Baidu轻应用AppBuilder平台模板开发者的技术参考.docxVIP

轻应用AppBuilder平台模板开发者技术参考1.概述App Builder是通过百度云能力优化各行业之间的资源配置并助力落地商户快速创建轻应用的服务平台。开发者可以利用App Builder方便地将自己拥有的资源以WebApp的形式发布为轻应用，并以百度轻应用渠道接入与推广出去。一方面，App Builder实现了对数据的加工、存储，以及对优质数据搜索引擎对接；另一方面，App Builder通过提供组件化的输出支持，及最领先的云能力支持，为用户提供与native app相同的使用体验。1.1模板App Builder以模板概念对开发者进行技术支持，联接技术型开发者与应用创建者。模板是运行在BAE上的一套代码，提供包括应用数据的后台管理与前台展示的功能。一方面，技术型开发者可以开发出自己的模板并提交到App Builder平台中，另一方面，应用创建者可以将手中的资源接入到模板中，生成轻应用。一个模板可以根据需求定制生成出多个轻应用。模板提供的功能有：应用创建与初始化模板帮助应用创建者完成创建与初始化轻应用，如选择应用基本样式、填充默认数据，并将应用发布到轻应用接入系统中应用内容管理应用发布后，模板提供管理与维护应用的功能，包括更新应用内容、修改应用配置等应用访问界面当应用上线后并被搜索及访问时，模板提供应用的展示与交互界面更多关于模板的详细技术细节请参考第二章节内容。1.2API与 SDKApp Builder对应用数据的组织形式有着了规范化要求，以便于搜索接入及组件化输出。应用数据在App Builder中以key-value形式存在，App Builder提供了完整的API供模板控制应用数据，包括：数据访问包括应用数据的存取与遍历、查找等。通过对应用数据结构的设计，模板可以利用key-value形式存储任意数据，并利用API的不同数据访问接口实现整个应用的数据逻辑写入检索信息在应用数据更新成功后，模板通过调用对应API即可将检索信息同步到搜索引擎中。API为不同的应用类型提供了丰富的搜索引擎个性化展示方案，供模板开发者选择控制应用状态为了便于模板开发者维持线上数据的稳定性，App Builder提供了数据预览机制，将数据区分为线下与线上环境。模板可以为应用创建者提供交互功能，使用户可以在数据维护完成后，通过调用API提供的发布接口主动将线下环境的预览数据同步到线上，同时同步检索信息到搜索引擎中后端推送数据如果模板面向的应用创建者是拥有后端开发能力的开发者，模板可以为开发者提供后端调用接口，API将为模板后端接口提供接入支持。开发者创建应用后，可以根据当前应用信息以Oauth2.0授权方式调用API，API将请求转发给模板，实现后端数据更新等机制。为了便于模板开发者使用API，我们提供了常用编程语言的SDK封装，包括php、js等。模板开发者只需下载或引用SDK代码后，即可使用SDK提供的编程接口方便地访问API。关于API与SDK的详细信息请参考第三章节内容。2.模板接入App Builder提供了一种基于token的请求鉴权机制，以实现应用数据的隔离及请求的有效性检查。当应用创建者创建或管理应用时，App Builder将向用户展示模板的创建或管理页面，并在页面地址中附加token参数。页面后端代码可以利用该参数构造请求访问API，得到应用数据（SDK已实现了访问API时token参数的传递功能）。当用户浏览到已上线的应用时，手机浏览器的请求将由App Builder转发给模板，并附加上token参数。token是一个特殊加密的字符串，包含应用信息、请求信息等。应用创建者通过App Builder平台查看自己的应用的创建或管理页面时，App Builder将生成有效期为1000天的admin token，模板可以利用该token读写线下预览数据，并控制应用数据的发布；用户浏览应用时，App Builder后端将生成有效期为120秒的guest token，模板可以利用该token读写线上数据。2.1模板的开发与调试模板可以用任意BAE支持的语言进行开发（目前BAE支持php、java、python、nodejs等语言）。为了方便模板开发者的编程与调试，App Builder的数据API支持调试模式，开发者可以在本地开发模板代码，并以test token(点此获取)进行测试，利用test token生成的应用数据存储在用户的个人云存储(PCS)中，数据key以appid为命名空间。开发者登录并获取test token后，在调试本地代码时需要将token参数写在url中。例如：token为ZeZPX4vVAS40bK79TV25rOhfb4G6KV1DolsSek0rO-JriTfv，页面地址为：http://local