APP打包工具与文档

发布时间:2015-10-29

1. dcc工具及使用说明

1.1.dcc介绍

  dcc工具下载地址:http://123.56.138.152:8001/windows-exe/dccTools.rar

  dcctools用来给项目生成dcc文件,让用户设备访问服务端时具备游戏项目文件增量更新的功能。dcc文件提供项目文件的更新信息,它根据项目生成若干dcc配置信息文件。LayaPlayer在启动的时候,会根据从服务器获取的dcc配置信息,确定需要更新什么文件到移动设备上。dcctools是用node.js开发的,可以在Windows和Linux上运行。

  Windows(win32)版和Linux版的node.exe都已经放在了解压出的目录里,他们不需要安装。

1.2.dcc工具的使用

1.2.2.genDcc.脚本命令说明

  这个工具是命令行程序,为了使用方便,最好再通过脚本封装一下。脚本示例如下:

node genDcc.js 输入目录 输出目录 [是否打包资源] [是否转小写]

  最后两个参数是为打包资源用的,在生成dcc的时候可以没有;如果使用,1表示true,0表示false。

1.2.3.打包脚本命令的其他参数说明

输入目录

  应用目录,例如 e:/myproj/game1 ,应用目录就是包含应用首页的目录。

输出目录

  结果会保存到输出目录,对于dcc来说,需要用到其中的assetsid.txt、filetable.bin、filetable.txt、allfiles.txt文件。(注意:此工具执行的时候会修改所有文件的修改时间,目的是为了防止cdn在回源的时候以为文件没有被修改。如果不需要此功能,需要改js源码)。

  实际使用的时把生成的这几个文件拷贝到网站的update目录下。例如,应用页面为game1.layabox.com,就需要game1.layabox.com有个update子目录,并拷贝上面的输出目录里的文件。

  目录下面有几个预先写好的例子可供参考

genDcc.bat文件

  执行的时候传入一个目录作为参数(可以拖放到这个批处理上)。输出结果在当前目录的 update 目录下,实际使用的时候要把update目录拷贝到应用目录。

svhook_gendcc.sh

  这个脚本的应用场景是在服务器的环境下,同时是给多个应用生成dcc。

1.2.4.流程示例

本地使用dcc配置

  在本次示例,D:\projects\layaDocument\developerCenter\demos\pandaRun\bin\h5 ”是本地一个LayaFlash项目的H5输出目录,使用这个目录名作为讲解的案例目录名。首先,确认项目目录文件是最新的文件,在将整个目录拖到dcc工具目录的genDcc.bat上:

1c.png

  弹出的cmd提示窗口中打印配置文件的生成情况:

2.png

  如果没任何错误,看到提示“请按任意键继续”表示完成dcc配置文件的生成,打开genDcc.bat文件同目录下的update文件夹,里面新产生了几个文件,这些都是新生成的项目文件配置信息文件,将整个update文件夹复制“D:\projects\layaDocument\developerCenter\demos\pandaRun\bin\h5”里。重启本地项目,就可以使用dcc检测最新文件更新功能了。但要注意的是每次编译项目后都要使用dcc工具重新生成一次update文件夹,并覆盖H5项目输出目录下的update文件夹。


发布到服务端

  /data/wwwroot/games/game1为服务器上的应用目录。写一个脚本,给这个目录生成dcc,并拷贝结果到update下。

  先更新 /data/wwwroot/games/game1。再执行脚本。最后测试。当然,也可以在客户端先生成dcc,然后把update目录一起更新到服务器上就好。

  也可以使用带有update文件夹的本地项目更新到服务端上,但必须注意上传到服务端的过程中不能修改update文件夹里文件的数据,否则终端设备加载项目文件时容易发生校验错误的问题。


1.2.4.常见问题

1.2.4.1.客户端报校验错误

  这个可能的原因很多,在没有cdn的情况下,一种可能是文本文件的回车换行的问题,即文件在发到服务器以后,回车换行被上传工具修改了。例如svn,git,和部分上传软件都会做这种转换,解决方法是通过设置去掉这种转换。

1.2.4.2.在服务器执行的时候提示很多错误

  如果目录下有很多错误编码的中文文件,就会报错,结果是最终生成的dcc文件不包含这些文件。


2.PackingTool使用说明

2.1.PackingTool可以用来打微端包和资源包。

  微端包只提供了游戏URL,在运行游戏的时候所有资源都是即时从网上下载,并且缓存到本地。

资源包是把项目的所有资源(其中包括:js、html、图片、声音等)按照LayaPlayer的格式进行打包,并拷贝apk的资源目录下。运行游戏的时候直接读取本地资源,而无需从网上下载。

  PackingTool打包工具下载地址(v0.5.1):http://layaflash.ldc.layabox.com/laya_tools/xsdk.zip

2.2.需要提供的有

AppName:游戏的名字。

PackageName:应用的包名。

GameIcon:游戏图标(注:需要144*144的png图片)。

GameURL:游戏连接的地址。

KeyStore:签名文件以及密码。

2.3.运行环境:目前只支持windows-7  64位系统

2.4.操作说明

2.4.1.首先打开PackingTool.exe

  1.png

   第一次打开会首先下载LayaPlayer最新版。

  2.png

2.4.2.输入相关参数

  3.png

  注:图片一定要是144*144的png图片。点击下一步。

2.4.3.会打开生成资源包的窗口

 4.png

  选择资源路径以后,再点击生成资源包: 

  5.png

  注:如果要打资源包,一定要点击“生成资源包”按钮。最终会将资源打包到“/assets/cache/”目录下面。如果不点击“生成资源包”则会打成微端包。

2.4.3.点击打包

 6.png

  7.png

  完成以后则会在配置的输出目录下面生成定制的apk包。