设置环境
请遵循以下准则和说明来设置网页应用的环境。
包含亚马逊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打包网页应用提交到亚马逊应用商店
- 登录您的亚马逊账户
- 转到新Web应用程序提交页面。
- 选择是否提交托管网页应用或打包网页应用。（在当前情景下，选择后者）。
- 在上传您的应用文件屏幕上，将网页应用文件（HTML、JavaScript、CSS、内容文件/资源）作为zip文件上传。
- 在剩余的应用提交屏幕上提供有关打包的网页应用的其他详情。
- 在审核和提交屏幕上，单击提交应用。
Last updated: 2023年10月2日
