简介

简介

云集是 Web app 的运行环境。基于不同的平台,云集运行环境有不同的实现。云集向符合规范的 hosted Web apps 和 packaged Web apps 提供多种 API 支持,增强 Web app 的能力。

W3C Web App Manifest

云集在一定程度上支持 Manifest,主要通过以下方式:

  • 用户可以手动输入 Web app 的 Manifest 网址来添加 Web app。
  • 云集会匹配形如 “cloudboxone://” 的 URL Scheme,从而引导用户添加 Web app 至云集中。
  • 云集开发者中心为开发者生成的 Web App 的二维码展示页面(比如 http://developer.tinydust.cn/api/app/JH2Yn )会自动判断访问者的设备 User Agent,如果为手机端的访客,则自动跳转到以上的 URL Scheme 或 intent。

但是,我们暂未支持 Manifest 中的相对路径。也就是说,您的 Manifest 文件中的所有网址都必须是以 http 开头的绝对路径。目前,云集识别 Manifest 中的以下字段:

  • name: 应用名称
  • launch_url: 应用网址
  • icons
    • 128 128 x 128 的应用图标
  • developer
    • name 应用开发者名称
    • url 应用开发者网站

例:

{
    "name": "云集 Web Store",
    "developer": {
        "name": "PortWatcher",
        "url": "http://pwhack.me"
    },
    "icons": {
        "128": "http://cdn.lydiabox.com/xxxx_128.png"
    },
    "launch_url": "http://webstore.lydiabox.com"
}

对于 Manifest 的类型,目前云集识别的 MIME Type 有:

  • text/plain
  • application/json
  • application/x-web-app-manifest+json

权限

任何与权限有关的调用都会弹出一个提示框来让用户进行授权,若用户同意此次权限申请,API 将继续调用,否则 API 将停止调用。

当用户授权后,授权有效期根据平台特性而不同,云集 iOS 的授权有效期为云集的本次应用周期,也就是说,当云集被系统或用户终结后,下一次启动时所有权限将被重置。

您不应当在用户已经拒绝授权后再次申请权限。

Last updated on 19th Sep 2016