开发者控制台

设置环境

设置环境

请遵循以下准则和说明来设置网页应用的环境。

包含亚马逊API JavaScript库

如果您的网页应用使用亚马逊API(例如应用内购买(IAP)),请在代码中包含亚马逊API JavaScript库,以便使用这些API。

托管应用

对于托管应用,亚马逊API JavaScript文件托管在以下URL:

https://resources.amazonwebapps.com/v1/latest/Amazon-Web-App-API.min.js

<script>标记添加到HTML <body>的末尾,以将此文件包含在网页应用中:

<script src="https://resources.amazonwebapps.com/v1/latest/Amazon-Web-App-API.min.js"></script>

打包应用

创建打包应用

创建新的打包应用就像创建其他类型的zip文件一样简单。请确保应用具有作为其起始页index.html文件,或在提交应用时指明应用主启动页的路径。要确保应用可以在离线状态下正常工作,还需包含所有这些资产。

可以使用GUI应用(如WinZip),也可以从命令行使用zip。这个用于压缩文件夹的命令将生成所需的基本zip文件:$ zip -r project.zip ./project

打包HTML5应用项目的外观和工作方式与服务器上的普通Web项目文件夹一样。

对于打包应用,亚马逊API JavaScript文件会自动注入到.zip文件的根级别。在<script>标记中使用相对URL来引用该文件。

例如,应用的文件位于.zip存档的顶层,如下所示:

Package.zip/
  index.html
  js/index.js
  css/index.css
  html/other.html
  images/image1.png

Amazon-Web-App-API.min.js添加到与index.html相同的级别。使用以下<script>标记将Amazon-Web-App-API.min.js包含在以下HTML文件中:

index.html中:<script src="Amazon-Web-App-API.min.js"></script>

html/other.html中:<script src="/Amazon-Web-App-API.min.js"></script>

如果应用的文件位于.zip存档中的文件夹内,如下所示:

Package.zip/
   MyApp/
      index.html
      js/index.js
      css/index.css
      html/other.html
      images/image1.png

Amazon-Web-App-API.min.js添加到与MyApp文件夹相同的级别。使用以下<script>标记将Amazon-Web-App-API.min.js包含在以下HTML文件中:

MyApp/index.html中:<script src="/Amazon-Web-App-API.min.js"></script>

MyApp/html/other.html中:<script src="/Amazon-Web-App-API.min.js"></script>

使用亚马逊API JavaScript库

从亚马逊HTML5框架触发amazonPlatformReady事件后,必须调用网页应用中所有使用亚马逊API的代码。

document.addEventListener('amazonPlatformReady', function () {
  //此处使用API代码
});

指定启动路径

应用的启动路径是应用首次启动时应加载的文件的路径。

托管应用

对于托管应用,启动路径是网页应用的URL。将托管应用提交到亚马逊应用商店时,请指定应用启动时要加载的页面的URL。

打包应用

对于打包应用,启动路径是应用首次启动时应加载的HTML文件,与.zip存档的根目录相对应。例如,如果应用首次启动时要启动index.html,并且该文件位于zip存档的根级别,则应使用/index.html。如果文件位于名为MyApp/的子目录中,则启动路径为/MyApp/index.html。将应用提交到亚马逊应用商店时,请将此URL指定为启动URL。

网页应用权限

如果应用所使用的一项或多项功能需要客户权限,请在提交流程中勾选相应的复选框。如果应用需要任何客户权限(应用内购买或用户登录),则必须配置关联的页面以使用SSL。下表详细说明了需要权限的功能: 

功能 权限
应用内购买 允许网页应用使用亚马逊的应用内购买API
地理位置 允许网页应用使用位置功能
存储 允许网页应用从外部存储执行读/写操作

为了保护客户,如果您的网页应用使用应用内购买或需要身份验证,我们要求您使用SSL为应用提供服务。有关更多信息,请参阅保护网页应用

测试打包网页应用

Amazon Web App Tester已升级,也可以处理打包网页应用。如果您不熟悉Amazon Web App Tester,请参阅博客文章:充分利用Amazon Web App Tester。该文章介绍了如何在提交网页应用之前使用Amazon Web App Tester来测试应用,包括如何启用和使用远程开发工具,以及其他提示和技巧。

除了为托管网页应用输入URL之外,开发者现在还可以将其压缩网页应用文件加载到设备上,Amazon Web App Tester将拉取这些文件进行查看/调试。使用Android File Transfer工具,将要测试的压缩网页应用文件复制到设备根目录下的文件夹:/amazonwebapps

然后,应用包文件应该显示在Amazon Web App Tester中,可以单击“Extract(解压缩)”,然后按常规方式使用应用。还可以输入指向打包zip文件的URL,并按照上述步骤操作。

将HTML5打包网页应用提交到亚马逊应用商店

  1. 登录您的亚马逊账户
  2. 转到新Web应用程序提交页面。
  3. 选择是否提交托管网页应用或打包网页应用。(在当前情景下,选择后者)。
  4. 上传您的应用文件屏幕上,将网页应用文件(HTML、JavaScript、CSS、内容文件/资源)作为zip文件上传。
  5. 在剩余的应用提交屏幕上提供有关打包的网页应用的其他详情。
  6. 审核和提交屏幕上,单击提交应用

Last updated: 2023年10月2日