使用Bubble wrap将PWA转为Native App后,如何设置超12字符的应用名?
解决Bubble Wrap生成Android应用主屏幕显示长名称的问题
我们用Bubble Wrap将PWA转换为Android应用并部署到Play Store时,遇到了和文档不符的显示问题:按文档说明,应用名称(长名称)应该显示在图标下方,短名称仅在空间不足时展示,但实际主屏幕默认显示的是短名称,而短名称最多只能设12字符,我们需要显示20字符的应用名称,以下是可行的解决方法:
方法1:手动修改AndroidManifest.xml
Bubble Wrap生成的Android项目中,默认会把配置里的name映射为android:label,short_name映射为android:shortLabel,但部分Launcher会优先显示shortLabel。直接修改Manifest文件强制优先使用长名称:
- 打开生成的
android/app/src/main/AndroidManifest.xml - 在
application标签中:- 确保
android:label设置为你的20字符长名称 - 可以删除
android:shortLabel属性,或者将其设置为和长名称一致(如果不需要短名称) - 检查所有
activity标签的android:label,确保它们继承或设置为相同的长名称
- 确保
方法2:调整Bubble Wrap配置文件(twa-manifest.json)
如果需要保留短名称的配置,但让生成的项目优先使用长名称:
- 在
twa-manifest.json中,name字段填20字符的长名称,short_name字段保留12字符内的短名称 - 重新生成项目时,Bubble Wrap默认会按配置映射长/短名称,若之前有异常,可手动确认生成的Manifest中
android:label已正确关联长名称
方法3:处理Launcher差异
部分定制化Android Launcher(如小米、华为的系统UI)会强制显示短名称,这时候可以:
- 完全移除
android:shortLabel的设置,让系统自动根据空间截断长名称,而非强制使用短名称 - 在
res/values/strings.xml中定义长名称字符串,然后在Manifest中引用该字符串,确保所有组件的标签统一指向长名称
验证
修改完成后,编译测试APK,安装到不同品牌的Android设备上验证主屏幕显示效果,确保长名称正常展示。
内容的提问来源于stack exchange,提问作者Saroj
相关产品推荐
相关产品推荐

