如何上架HarmonyOS应用
作者：songxixi agc应用分发技术专家
大家一直以来都很关心如何上架harmonyos应用，现在它来了!它终于来了!我们为大家梳理了harmonyos应用从创建、调试到上架的流程和注意事项，希望能为你的上架之旅带来帮助!
一、创建/添加应用
harmonyos应用开发好后，不管是调试还是上架应用，首先都需要在appgallery connect(后文简称：agc)创建/在项目下添加harmonyos应用。而当前创建应用的方式是根据开发者帐号态和受邀名单进行管控的，详情如下表所示：
我们从表中可以发现，如果要直接创建应用和上架应用，则必须满足“已实名+已在受邀名单”，如果只是在项目下添加应用和调试应用，则对账号状态和受邀名单与否无要求。所以要上架应用的小伙伴先确认自己是否满足前提条件(如何实名和加入受邀名单在上架应用章节会介绍)。
1. 直接创建应用
用已实名且在受邀名单的开发者帐号登录agc网页，在页面“我的应用”(图1)。
图1 agc网页
点击“我的应用”进入后会出现“harmonyos应用”页签(图2)。选中“harmonyos应用”，即可创建harmonyos应用，具体参见直接创建应用。
图2 “harmonyos应用”页签
2. 项目下添加应用
在项目下添加应用之前，如果还未在agc创建项目，则需要大家先创建项目，这样就可以将一个应用的不同平台版本添加到同一个项目中(比如一个应用有android版本和harmonyos版本，则可以都将它们都添加到同一个agc项目中)，具体参见创建项目。
有了agc项目后，就可以登录agc页面，进入“我的项目”中(图3)，然后添加创建harmonyos应用，具体参见在项目下添加应用。
图3 我的项目
注意点：
1)agc创建应用填写的包名必须全网唯一，harmonyos应用包名也不能和安卓应用包名重复，如果提示包名被占用，则需要更换包名。
2)直接创建harmonyos应用不需要填写包名，通过上传的软件包自动解析。在项目下添加harmonyos应用必须填写包名
3)在项目下可以添加已有的应用，选择应用后不要修改应用名称，否则会认为是新建应用。
二、调试应用
harmonyos应用开发完成后，且已经在agc完成了应用的创建并添加到项目中，就可以开始进行调试了。如果仅仅在模拟器中调试，可以不配置签名信息;但如果需要在真机中调试，则必须配置签名信息。华为提供了两种应用调试(签名)方法：自动化签名方式和手动签名方式，上架则必须为手动签名。
1. 自动签名
直接在开发工具huawei deveco studio(后文简称：ide)中完成自动化签名并调试，具体参见使用模拟器进行调试。
使用模拟器进行调试
注意点：
1)如果ide没有自动签名选项，建议升级ide至最新版本。自动签名特性仅在deveco studio v2.1 release及更高版本中支持。
2)自动化签名的调试方式会自动在agc中创建用于调试的数字证书和profile文件，但当前agc调试证书最多仅支持2个，即最多同时只支持为两个应用进行自动化调试，如已达到上限，需要在“用户与访问 > 证书管理”页面中“废除”多余的调试证书文件。
3)调试设备最多支持100个。
4)harmonyos应用的config.json文件中的“bundlename”取值必须和agc应用包名保持一致，如包名冲突，可以修改bundlename进行规避。
5)如果报错连接agc网站失败，请检查是否使用代理等，可以断开代理重试。
2. 手动签名
相关流程如图4所示，首先在ide中生成秘钥和证书请求文件，然后拿着在ide生成的这两个文件再去agc申请应用调试证书和调试profile文件，最后回到ide中配置签名，编译构建app，然后就可以进行调试了。详细流程请参考手动调试harmonyos应用。
手动调试harmonyos应用
图4 调试签名流程图
注意点：
1)本地调试一定要使用调试证书和调试profile文件，并且调试证书和profile文件要匹配。如果使用发布证书和发布profile文件用于调试场景将会导致应用无法安装。2)当前agc调试证书最多仅支持2个，如已达到上限，需要在“用户与访问 > 证书管理”页面中“废除”多余的调试证书文件。3)申请调试profile文件的应用一定要和本地调试的应用匹配。
三、上架应用
本地调试完毕后，就可以打包harmonyos应用，在agc提交上架。如图5所示，和调试类似，开发者需要先在ide中生成秘钥和证书请求文件，然后拿着在ide中生成的这两个文件去agc申请应用发布证书和发布profile文件(注意是发布证书，不再是调试证书了)，然后再回到ide中配置签名和编译构建app，上述工作完成后才进入应用的上架。
图5 上架应用流程图
以上就是创建应用、调试应用和上架应用的介绍啦，最后我们再通过下面这张上架全流程图(图6)帮助大家把以上内容串起来~
图6 上架全流程
因篇幅有限，此处不再赘述流程图中步骤的详细操作，详情请点击对应链接查看：
步骤1 开发者账号实名
步骤2 发邮件申请加入受邀名单
步骤3和4 生成秘钥和证书请求文件
步骤5 在agc创建项目
步骤6 在项目下添加harmonyos应用
步骤7 申请应用发布证书
步骤8 申请发布profile文件
注意点：
1)当前agc最多可申请1个发布证书;最多可申请100个profile文件。
2)发布应用一定要使用发布证书和发布profile文件，并且发布证书和profile文件要匹配。如果使用调试证书和调试profile文件用于发布场景将无法上传软件包。
3)申请发布profile文件的应用一定要和发布应用匹配。
步骤9 配置签名信息
步骤10 编译构建app
注意点：
1)最终编译构建的harmonyos应用软件包应为.app格式，且不能超过2gb。否则，软件包将无法上传。
2)除了.app包外，agc还会解析检测.app包中的.hap包大小：运动手表/路由器类型的hap包大小不能超过20mb，手机/智能手表/大屏类型的hap包大小不能超过2gb。
3)免安装的.hap包不能超过10mb。
4)编译.app包所用的发布证书一定要使用agc下载的证书，否则会导致上传软件包失败。
步骤11 上架harmonyos应用
注意点：
1)上传的应用图标，截图，视频等需要满足应用市场要求，否则上传失败。
2)如果需要提前小范围测试应用，可以选择开放式测试版本发布。
3)上传素材或软件包需要纯公网环境，使用代理等需要断开连接。
四、结语
以上就是我们为大家梳理的流程和注意点，感谢大家一如既往的支持，如有更多问题，欢迎点击下方阅读原文，前往论坛留言，我们将根据大家反馈的问题，持续改进和优化!
原文标题：一文带你看懂harmonyos应用上架
文章出处：【微信公众号：harmonyos开发者】欢迎添加关注!文章转载请注明出处。
从今年的半导体收购，看代理商的未来走势
ML与传感，软硬件结合的传感技术又将升级机器人感知能力
基于ESP32的网络收音机
小米8 SE性能如何以及联想Z5多少钱？
华为正式发布了业务创建智能中心（SCC）解决方案
如何上架HarmonyOS应用
东芯股份拟布局无线通信芯片业务，设立子公司和分公司
海尔56亿美金惊天收购美国通用
浅谈PLC和继电器的控制方式
霉菌培养箱的应用优势具体都有哪些
两年前折戟创业板，如今剑指科创板，云涌科技何时能圆上市梦？
凌力尔特推出升压型DC/DC控制器LTC3872的H级版本
DacomHF002蓝牙耳机怎么样 值不值得买
世博国家电网馆：打开“魔盒”点亮梦想
数字孪生智慧校园Web 3D可视化监测
小米6、荣耀V9对比评测：小米6遭遇“充电门”缺货黄牛还加价，华为荣耀V9笑了
数字电路基础知识分享2
浅谈电容器的分类
超融合和虚拟化的区别
长时间戴耳机耳朵不舒服？可能你没有试过骨传导耳机
大家一直以来都很关心如何上架harmonyos应用，现在它来了!它终于来了!我们为大家梳理了harmonyos应用从创建、调试到上架的流程和注意事项，希望能为你的上架之旅带来帮助!
一、创建/添加应用
harmonyos应用开发好后，不管是调试还是上架应用，首先都需要在appgallery connect(后文简称：agc)创建/在项目下添加harmonyos应用。而当前创建应用的方式是根据开发者帐号态和受邀名单进行管控的，详情如下表所示：
我们从表中可以发现，如果要直接创建应用和上架应用，则必须满足“已实名+已在受邀名单”，如果只是在项目下添加应用和调试应用，则对账号状态和受邀名单与否无要求。所以要上架应用的小伙伴先确认自己是否满足前提条件(如何实名和加入受邀名单在上架应用章节会介绍)。
1. 直接创建应用
用已实名且在受邀名单的开发者帐号登录agc网页，在页面“我的应用”(图1)。
图1 agc网页
点击“我的应用”进入后会出现“harmonyos应用”页签(图2)。选中“harmonyos应用”，即可创建harmonyos应用，具体参见直接创建应用。
图2 “harmonyos应用”页签
2. 项目下添加应用
在项目下添加应用之前，如果还未在agc创建项目，则需要大家先创建项目，这样就可以将一个应用的不同平台版本添加到同一个项目中(比如一个应用有android版本和harmonyos版本，则可以都将它们都添加到同一个agc项目中)，具体参见创建项目。
有了agc项目后，就可以登录agc页面，进入“我的项目”中(图3)，然后添加创建harmonyos应用，具体参见在项目下添加应用。
图3 我的项目
注意点：
1)agc创建应用填写的包名必须全网唯一，harmonyos应用包名也不能和安卓应用包名重复，如果提示包名被占用，则需要更换包名。
2)直接创建harmonyos应用不需要填写包名，通过上传的软件包自动解析。在项目下添加harmonyos应用必须填写包名
3)在项目下可以添加已有的应用，选择应用后不要修改应用名称，否则会认为是新建应用。
二、调试应用
harmonyos应用开发完成后，且已经在agc完成了应用的创建并添加到项目中，就可以开始进行调试了。如果仅仅在模拟器中调试，可以不配置签名信息;但如果需要在真机中调试，则必须配置签名信息。华为提供了两种应用调试(签名)方法：自动化签名方式和手动签名方式，上架则必须为手动签名。
1. 自动签名
直接在开发工具huawei deveco studio(后文简称：ide)中完成自动化签名并调试，具体参见使用模拟器进行调试。
使用模拟器进行调试
注意点：
1)如果ide没有自动签名选项，建议升级ide至最新版本。自动签名特性仅在deveco studio v2.1 release及更高版本中支持。
2)自动化签名的调试方式会自动在agc中创建用于调试的数字证书和profile文件，但当前agc调试证书最多仅支持2个，即最多同时只支持为两个应用进行自动化调试，如已达到上限，需要在“用户与访问 > 证书管理”页面中“废除”多余的调试证书文件。
3)调试设备最多支持100个。
4)harmonyos应用的config.json文件中的“bundlename”取值必须和agc应用包名保持一致，如包名冲突，可以修改bundlename进行规避。
5)如果报错连接agc网站失败，请检查是否使用代理等，可以断开代理重试。
2. 手动签名
相关流程如图4所示，首先在ide中生成秘钥和证书请求文件，然后拿着在ide生成的这两个文件再去agc申请应用调试证书和调试profile文件，最后回到ide中配置签名，编译构建app，然后就可以进行调试了。详细流程请参考手动调试harmonyos应用。
手动调试harmonyos应用
图4 调试签名流程图
注意点：
1)本地调试一定要使用调试证书和调试profile文件，并且调试证书和profile文件要匹配。如果使用发布证书和发布profile文件用于调试场景将会导致应用无法安装。2)当前agc调试证书最多仅支持2个，如已达到上限，需要在“用户与访问 > 证书管理”页面中“废除”多余的调试证书文件。3)申请调试profile文件的应用一定要和本地调试的应用匹配。
三、上架应用
本地调试完毕后，就可以打包harmonyos应用，在agc提交上架。如图5所示，和调试类似，开发者需要先在ide中生成秘钥和证书请求文件，然后拿着在ide中生成的这两个文件去agc申请应用发布证书和发布profile文件(注意是发布证书，不再是调试证书了)，然后再回到ide中配置签名和编译构建app，上述工作完成后才进入应用的上架。
图5 上架应用流程图
以上就是创建应用、调试应用和上架应用的介绍啦，最后我们再通过下面这张上架全流程图(图6)帮助大家把以上内容串起来~
图6 上架全流程
因篇幅有限，此处不再赘述流程图中步骤的详细操作，详情请点击对应链接查看：
步骤1 开发者账号实名
步骤2 发邮件申请加入受邀名单
步骤3和4 生成秘钥和证书请求文件
步骤5 在agc创建项目
步骤6 在项目下添加harmonyos应用
步骤7 申请应用发布证书
步骤8 申请发布profile文件
注意点：
1)当前agc最多可申请1个发布证书;最多可申请100个profile文件。
2)发布应用一定要使用发布证书和发布profile文件，并且发布证书和profile文件要匹配。如果使用调试证书和调试profile文件用于发布场景将无法上传软件包。
3)申请发布profile文件的应用一定要和发布应用匹配。
步骤9 配置签名信息
步骤10 编译构建app
注意点：
1)最终编译构建的harmonyos应用软件包应为.app格式，且不能超过2gb。否则，软件包将无法上传。
2)除了.app包外，agc还会解析检测.app包中的.hap包大小：运动手表/路由器类型的hap包大小不能超过20mb，手机/智能手表/大屏类型的hap包大小不能超过2gb。
3)免安装的.hap包不能超过10mb。
4)编译.app包所用的发布证书一定要使用agc下载的证书，否则会导致上传软件包失败。
步骤11 上架harmonyos应用
注意点：
1)上传的应用图标，截图，视频等需要满足应用市场要求，否则上传失败。
2)如果需要提前小范围测试应用，可以选择开放式测试版本发布。
3)上传素材或软件包需要纯公网环境，使用代理等需要断开连接。
四、结语
以上就是我们为大家梳理的流程和注意点，感谢大家一如既往的支持，如有更多问题，欢迎点击下方阅读原文，前往论坛留言，我们将根据大家反馈的问题，持续改进和优化!
原文标题：一文带你看懂harmonyos应用上架
文章出处：【微信公众号：harmonyos开发者】欢迎添加关注!文章转载请注明出处。
从今年的半导体收购，看代理商的未来走势
ML与传感，软硬件结合的传感技术又将升级机器人感知能力
基于ESP32的网络收音机
小米8 SE性能如何以及联想Z5多少钱？
华为正式发布了业务创建智能中心（SCC）解决方案
如何上架HarmonyOS应用
东芯股份拟布局无线通信芯片业务，设立子公司和分公司
海尔56亿美金惊天收购美国通用
浅谈PLC和继电器的控制方式
霉菌培养箱的应用优势具体都有哪些
两年前折戟创业板，如今剑指科创板，云涌科技何时能圆上市梦？
凌力尔特推出升压型DC/DC控制器LTC3872的H级版本
DacomHF002蓝牙耳机怎么样 值不值得买
世博国家电网馆：打开“魔盒”点亮梦想
数字孪生智慧校园Web 3D可视化监测
小米6、荣耀V9对比评测：小米6遭遇“充电门”缺货黄牛还加价，华为荣耀V9笑了
数字电路基础知识分享2
浅谈电容器的分类
超融合和虚拟化的区别
长时间戴耳机耳朵不舒服？可能你没有试过骨传导耳机