Freigeben über


博客园客户端UAP开发随笔 – App也需要物流前的打包

想起来一个笑话:唐僧一行千辛万苦来到佛祖面前,准备取经,佛祖轻声问了一句:汝等带U盘了吗?师徒4人立刻昏倒在地。好吧,扯远了,不过是想告诉大家准备工作一定要到位。

Universal App 的打包发布其实与传统的 Windows Phone / Windows Store App 项目并无太大不同,但是鉴于总有人会在这些步骤中遇到问题,而且即使是发布过几个应用的开发者也不例外,所以对这个看起来比较繁琐的过程做一个小结还是必要的。

 

打包前的准备工作

 

1. 修改编译模式

w8_00

在调试程序时,我们通常会选择 debug 模式,但是发布时不要忘记切换到 Release 模式,否则程序打包后连验证程序都不会执行,更不用说上传到应用商店了。为了保证程序在所有设备上都运行,我们选择 Any CPU,这样就可以保证我们的 UAP 运行在所有可以运行的平台上(包括基于 ARM 架构的 Windows RT 平板和基于 x86 架构的平板,例如 Surface Pro)了。

 

 

2. 修改 Manifest 文件

 

Manifest 文件记录了项目中的一些基础元数据,包括项目名称,申请的权限,项目的 Logo 和发布者信息等等,只有这些信息都填写完整并且准确,打包的文件才能保证通过上传时的自动验证。

w8_8

在项目中我们可以找到本项目的 appxmanifest 文件。

 

w8_0

我们还可以通过菜单中的选项找到修改 Manifest 文件的入口。

 

 

下面我们来逐个标签检查 Manifest 文件的内容是否完整。

w8_1

 

在 Application 标签页中,我们需要填写项目的基本信息,并确认是否需要修改对应的屏幕旋转方向和在锁屏时如何通知用户。

 

wp_1

与 Windows 项目不同的是, Windows Phone 项目还需要用户填写是否允许将 App 安装到 SD 卡的选项。

 

w8_2

在 Visual Assets 标签页中,我们需要将所有用到的 Logo 图片做好对应,一般来说,如果在 Assets 文件夹中图片的命名规范正确的话,这里可以自动检测并将图片自动载入的。

 

w8_3

需要注意的是,Badge Logo 的图片要求比较严格,要求只能有白色和透明两种颜色,哪怕有一个像素出现别的颜色,都会在自动验证程序时检测到并且不予通过,所以修改这几个图片的时候要务必小心,确认只包含白色和透明色。

 

w8_4

在 Capabilities 页面,我们需要填写项目申请的权限,例如本项目必须在网络下运行,所以必须申请 Internet 权限。最关键的注意事项是,任何 Windows App,如果申请了网络权限,就必须在 Setting 菜单中添加隐私声明 (Privacy Statement)的入口,否则会不能通过人工审核阶段。关于如何添加隐私声明,请参考之前的博客:博客园客户端(Universal App)开发随笔 - Setting Page的实现方法与经验

 

 

wp_2

Windows Phone 的项目还需要额外填写对于设备传感器的申请,如果在 App 中应用到了陀螺仪,磁场传感器,NFC,前/后摄像头等资源,需要在这里予以声明。

 

 

w8_5

在 Declarations 标签页中,我们要对 App 使用的其他资源进行声明,例如博客园项目使用到了后台任务,就需要在这里声明后台任务的入口。

 

w8_6

如果 App 使用到了特殊的通知事件,可以在 Content URIs 页面进行声明,需要注意的是,Windows 8.1 仅支持 https 协议的安全页面,不再支持 http 协议。

 

w8_7

Packaging 页面非常关键,这里的任何一项填错都会导致项目通不过上传时的自动审核。不过好在如果我们在下面的步骤中选择了将项目对应到商店中的 App,那么这个页面中的大部分项目都会自动填好。而如果我们选择仅仅打包,委托别人帮忙发布,那么这些信息就一定要填写完整。本页面中需要填写的信息,可以在对应的开发者账户页面找到信息。

另一个注意事项是最后的 Generate app bundle 选项。如果选择了 always,那么如果之前的 Visual Assets 中有对应的多种尺寸的图片,那么打包时就会生成一个对应多种尺寸设备的整包(bundle)。这样以后再更新项目,也必须上传一个 bundle,否则就不能通过上传审核。这也意味着,Assets 文件夹里的图片只能增加,不能再减少。

 

 

w8_9

当然以上的所有项目,我们都可以右键点击 manifest 文件,选择 view code 进行修改或更新。貌似这也是一个更适合 geek 的方法。

 

开始打包

Manifest 文件修改完之后,我们就可以开始正式的打包工作了。

w8_0

这里我们选择 Create App Packages

 

w8_10

在这里,有两种选择,选择Yes是直接登陆 Microsoft Dev 账户,将项目和商店中的 App 进行绑定,这样 Manifest 文件中关于开发者的信息会自动更新到 Microsoft Dev 账户的对应信息。这种方式适用于自己发布自己项目的情况。

选择No是不登陆账户,仅仅打包。这种情况适用于委托第三方帮忙发布项目的情况,或者是想先打个包出来给别人共享用作测试,测试完成后,你就可以直接用这个测试包提交应用了,这样更符合一般的工作流程,避免你的测试包和最后提交商店的包不一致。

我们强烈建议选择No,使用第二种方式。  在下一篇随笔中会详细说到如何提交应用。

w8_11

我们先选择第一种,登陆 Microsoft Dev 账户。

 

w8_12

登陆以后,该开发者之前提交过的项目就都显示出来,我们也可以为新项目重新预留一个名字。

 

w8_13

为项目选择版本信息,输出位置,是否打包生成和 CPU 等信息。

 

w8_14

都填写完之后,就可以打包项目了。打包完成后,会显示项目位置,并会提醒开发者为项目执行验证程序(Windows App Certification Kit)。由于上传后服务器会首先执行这个程序对项目进行初次自动验证,如果有不合规范的地方就不予通过,所以为了确保上传的成功性,我们通常会在本机先执行一次验证程序。

 

w8_16

w8_17

 

如果验证程序在本机通过,那么就可以向商店上传应用了。由于篇幅所限,我们会在将来的文章中继续介绍商店上传的注意事项。

 

总结

本文按照流程介绍了 Universal App 在上传商店前的打包步骤,并分析了 Windows 和 Windows Phone App打包时的细小区别和容易导致上传失败的注意事项。

 

我们的已经发布的应用和代码可以在下面找到:

Windows Phone Store App link:

https://www.windowsphone.com/zh-cn/store/app/博客园-uap/500f08f0-5be8-4723-aff9-a397beee52fc

 

Windows Store App link:

https://apps.microsoft.com/windows/zh-cn/app/c76b99a0-9abd-4a4e-86f0-b29bfcc51059

 

GitHub open source link:

https://github.com/MS-UAP/cnblogs-UAP

 

MSDN Sample Code:

https://code.msdn.microsoft.com/CNBlogs-Client-Universal-9c9692d1