App打包参数详解(V3.3)

优质
小牛编辑
132浏览
2023-12-01

选择应用模式:

db1

打包模式选择,参考:WeX5_V3.3平台App打包模式

设置服务地址和选择UI资源:

db2

  • 参数1:Web服务地址

指定加载UI资源的访问地址,也就是发布资源的服务器地址。
例如:案例淘宝为例,将其资源发布到版本所带tomcat中,该地址就是:http://localhost:8080。如图所示发布到版本所带tomcat中:

db12

修改tomcat端口号:参考:http://doc.wex5.com/bbs/forum.php?mod=redirect&goto=findpost&ptid=31304&pid=165038302

  • 参数2:Web路径

选择发布资源时,发布的资源在www目录下的目录名称。建议写项目名,可以达到见名知义的效果,不能使用默认的/X5、/x5/UI2等。
例如:案例淘宝为例,该处填写“taobao”,则如图所示:

db11

注意: 使用UIServer的情况(也就是使用模式3进行打包的时候),必须使用/X5/UI2。

  • 参数3:首页

App启动后,看到的首页,如果App启动时需要向服务器发送请求,所请求的首页面就是此配置的页面。
双击“选择需要发布的资源”中要显示的首页面即可。
例如:案例淘宝为例,双击要显示的首页“index.w”,如图所示:

db13

  • 参数4:选择需要发布的资源

选择需要发布到服务器上的资源,也就是APP中要运行的所有资源,如果在之后的操作中选择了“本地应用包含UI资源”,则选择的资源也会被包含到本地App中
注意:如果是模式3,这里可以不选任何资源,只要将“首页”填写正确即可。

配置应用信息:

db3

  • 参数1:版本号

设置App应用的版本号,由点隔开的三部分组成。如1.1.1。打包发布时需写新的序号,一个正式APP包对应一个版本号,以便用户在移动终端上安装时能检查到已安装应用进行更新。
注意:这里的版本号就是上传苹果AppStore中的版本号。

  • 参数2:应用包名

Android可以随意写(例如:com.justep.hello,不建议写com.justep.X,com.wex5.X容易和平台提供的案例等造成冲突)。
如果使用微信插件则包名必须与微信开放平台-移动应用中对应应用的包名一致
iOS必须输入证书中的BundleID。

  • 参数3:增强型浏览器

建议Android4.4以下版本选择,
选择增强型浏览器会使APP包在Android4.4以下版本的设备上使用时有更优的浏览性能,但APP包也会更大(多16M)。

  • 参数4:打包的资源加密

对之前选择的资源进行加密,加密后应用运行将略多一点资源读取时间,但可以增强应用的安全性,使反编译无法直接获取资源
如果之前的操作中,没有选择“选择需要发布的资源”,则此选项无效。

配置开发者信息和证书:

db4

打Android的APP包必须√选上Android证书项,输入Android证书密码,会根据上面所输入的开发者相关信息和证书密码,重新生成Android证书。
打iOS的APP包需要根据使用的是iOS的开发证书还是发布证书进行选择。输入iOS证书密码(是P12文件的密码),然后选择对应的P12文件和App验证文件。

设置屏幕选项:

db5

  • 参数1:屏幕方向

iphont 6 [s] plus 默认为竖屏,其他默认为自动旋转。

选择打包本地插件:

db6

  • 参数1:本地插件

默认为自动选择。也可以根据自己应用所使用Corodva插件的情况,手工选择相关插件。自动选择会根据之前选择的发布资源自动追加使用到的Cordova 插件,如果√选了自动追加使用到的Cordova插件,同时又手工选择了插件,打包时会把手工选择的插件也包含在应用中。如果√选了自动追加使用到的Cordova插件,那之后的操作必须√选“重新编译使用到的UI资源”,否则自动追加使用到的Cordova插件不会包含到应用中。
对于插件需提供参数值的情况,必须提供参数值,否则后面生成APP包时会报错。

  • 参数2:需参数配置

勾选,则筛选出所有需要配置参数的插件

本地应用信息:

db7

  • 参数1:源码模式

不可以选择,
通过打包时选择输出源码工程得到。

生成本地App包:

db8

  • 参数1:本地应用包含UI资源

勾选该选项后,会将要发布的资源编译后的结果包含的App中
模式1,第一次访问时将直接访问本地App中包含的资源。
模式2,访问时先与服务端部署资源比对版本,版本一致则访问App中的资源,如果版本不一致将从服务端读取新版本的资源。
模式3,访问时先与服务端UI资源比对版本,版本一致则访问App中的资源,如果版本不一致将从服务端读取新版本的资源。
发布时根据需要选择,开发调试时使用模式3不包含资源,这样设计器修改资源,就可以通过刷新来显示更新效果
如果勾选该选项,那么必须在前面选择所有需要包含的资源,不能只选择index.w

  • 参数2:重新编译使用到的UI资源

勾选该选项,将会在打包前先进行已选择打包资源的编译
如果在之前的步骤中选择的自动选择插件,编译后可分析出引用到的插件并且引用到App包中;
第一次打包时,必须选此选项,否则打包报错;之后打包,如果UI资源没有做修改,此选项可以不选择。

  • 参数3:输出源码工程

如果勾选该选项,那么必须输入工程名,源码工程会创建在Native目录下以所输入的工程名产生目录。生成的工程是带完整源代码的,可以自己用这个工程去手工编译。

  • 参数4:发布模式

选择发布模式后,不能使用真机调试,但是,微信分享等功能只能在发布模式的App中执行
使用iOS的发布证书(distribution)打包时必须勾选发布模式。
使用iOS的开发证书(developer)打包时,该项必须不勾选。

  • 参数5:使用应用打包服务器生成本地应用

windows环境下打iOS的App必须选择该选项。使用应用打包服务器,须输入应用打包服务器地址,地址输入后,需进行“连接测试”,以确定打包服务器可用。
在MAC下使用MAC版本打包时该选项可不选。
如果勾选该选项,那么必须进行打包服务器的安装,详见“搭建X5应用本地打包服务器”。

提示:开发调试过程中,建议使用模式3打包。

打包常见问题参考:http://doc.wex5.com/bbs/thread-82002-1-1.html

打包教程参考:http://doc.wex5.com/?p=10622