ActionScript
TypeScript
JavaScript

构建工具

发布时间:2016-12-29

 

使用 LayaAir IDE 创建的项目可以打包成 App在移动端运行。使用构建工具可以帮助开发者快速构建移动端 App 项目工程,然后使用相应的开发工具进行二次开发及渠道对接,最终发布 App。

目前支持构建的移动端 App项目工程类型有三种:

  • Android-eclipse(Android)

  • Android-studio(Android)

  • XCode(iOS)

点击菜单栏的“工具->app构建”可以打开【项目构建】对话框,在此对话框内设置好项目构建的常见配置信息后执行构建操作,将对在设置的输出路径生成对应的项目工程文件夹。

在使用构建功能之前,需要先配置一下构建工具所需的环境。

 

环境配置


需要已经安装了1.7(含)以上的jdk,如果没有安装,需要先安装一下。下载地址:http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html

点击菜单栏的 “工具->app构建”,如果弹出”环境安装向导“窗口,则说明你的IDE app构建 的环境还未配置完成。可按照环境安装向导配置环境。

1.png

1.打包app 和构建app 需要官方提供的运行环境,点击“跳转下载”按钮,进行下载。

下载地址:http://ldc.layabox.com/download/LayaAir/runtime/download.zip

2.下载完成后解压缩,将里面的几个文件覆盖到 IDE 的打包构建工具包下。可通过点击“打开目录”按钮打开覆盖目录。

覆盖目录: resources\app\out\vs\layaEditor\libs\RuntimePackTools\

3.覆盖后需要重启一下 IDE,此时环境已经配置完成啦。

 

 界面参数


app_built.png

 

平台:

构建生成的项目工程的类型。如果需要生成Android项目,可以选择Android-eclipse或Android-studio;如果需要生成XCode(ios)项目,则选择XCode(ios)选项。 

 

单机版app:

如果勾选此选项,则构建的项目打包的app是单机版,否则就是在线版。单机版通常不需要联网,没有对应的url,不用提供url。但是必须提供游戏资源,否则打包之后无法运行。

 

项目名称:

app的名称,同时也是构建项目的输出文件夹名称。


包名:

应用的包名,一般采用反域名命名规则(有利于分辨和避免与系统中已经游戏的app冲突)。例如:com.layabox.runtime.demo

包名必须是 xxx.yyy.zzz 的格式,至少要有两级,如xxx.yyy,否则打包会失败。


游戏url:

在线项目的构建打包需要提供一个在线的访问地址,指向一个html页面,是应用的入口。例如:http://layaair.ldc.layabox.com/layaplayer/index.html


输出路径:

构建生成的 App 工程项目的存放地址。

 

资源路径:

对于在线游戏,设置游戏url后就可以正常运行。如果把资源打进游戏app包中的话,可以避免每次进入游戏时都从网络上下载资源的问题,加快资源载入速度。

如果是单机游戏,不需要提供游戏在线url,就必须设置资源目录,把所需的资源全部打包进app。

打包进app的资源依然可以通过layadcc工具(资源缓存管理)进行更新。

打包资源的在线游戏,需要在server端打dcc,否则就会失去资源打包的优势,依然会下载所有的资源。如何打dcc,请参考<layadcc工具>。

 

构建好的项目工程的使用


 

构建好的 App工程,可以用对应的开发工具打开进行二次开发和打包等操作。

  • Android-eclipe(android)项目可以使用 eclipe软件进行导入和开发。

  • Android-studio(android)项目可以使用 android-studio软件进行导入和开发。

  • XCode(ios)项目可以使用 xcode 软件进行导入和开发。打开XCode(ios)项目后需要选择真正的ios设备进行build。(注意:真正的设备是 armv7、armv7s、arm64 架构。而如果使用ios Simulator 则是 X86 架构,目前 LayaNative 在 ios 设备上尚未支持 X86 架构,如果使用模拟器编译是无法通过的。

 

参考资源:

 

 

修改启动地址

构建好的项目也是可以修改游戏启动地址的,也就是在构建项目设置的游戏url地址。

XCode(ios)项目需要修改项目的index.js文件。

index.js 的目录:resource/scripts/index.js

修改示例如下:

loadUrl(conch.presetUrl||'http://lr.apple.dawawa.com/default.html');

 

Android-Eclipse和Android-Studio工程需要修改MainActivity.java文件:

mPlugin.game_plugin_set_option("gameUrl", "
http://10.10.20.71:9990/bin/index.html
");

 

 

注意问题


1.Android studio 项目构建完成后,需要根据自己的环境修改 android sdk 的版本号,目前设置的是23,配置文件: app/build.gradle。