设置环境
请遵循以下准则和说明来设置网页应用的环境。
包含亚马逊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日