egret-docs-master/Native/manual/projectsetting.md

2.8 KiB
Raw Permalink Blame History

title
如何发布原生项目

通过 Egret 引擎制作的游戏,不仅可以发布成 Html5 网页项目,还可以发布成原生项目。

发布设置前的准备工作

  • 安装最新版本的launcher
  • 确认引擎版本
    • 引擎版本必须为5.1.6及以上
  • 发布 iOS 需要安装Xcode
    • 建议版本: 9.0或以上
    • 后续需要在 Xcode 中完成发布项目的修改和功能接入
  • 发布安卓需要安装 Android Studio
    • 建议版本: 3.0或以上
    • 后续需要在 Android Studio 中完成发布项目的修改和功能接入

发布Android工程

发布项目

  • 在launcher的项目面板找到需要发布Android工程的Egret项目点击发布设置

  • 点击左侧的Android按钮在右侧页面中输入应用名称、应用包名点击确定。

发布iOS工程

发布项目

  • 在launcher的项目面板找到需要发布iOS工程的Egret项目点击发布设置

  • 点击左侧的iOS按钮在右侧页面中输入应用名称、应用包名点击确定。

工程设置

设置游戏地址

Android

nativeAndroid.initialize(gameUrl);

iOS:

[_native startGame:gameUrl];

launcher创建的默认工程会将游戏资源放到assets/game目录下这时会从assets目录加载游戏。如果不需要将游戏放到应用里请删除assets/game目录。

其它设置

可以通过修改nativeAndroid.config或_native.config的属性更改工程设置。

属性说明:

  • showFPS 是否显示fps面板
  • fpsLogTime log在屏幕上停留时间单位是秒-1为永久显示
  • disableNativeRender 是否禁用原生渲染加速
  • clearCache 是否清理缓存设置为true时每次启动都会清理缓存方便调试
  • loadingTimeout 加载index的超时时间。默认为0不设置超时
  • preloadPath 设置预加载目录,详见“热更新方案说明”
  • immersiveMode 开启沉浸模式默认不占用安全区刘海区域0.1.16添加,部分机型需要用户手动在设置中开启"应用全屏显示"
  • useCutout 占用安全区。0.1.16添加,如果没有开启沉浸模式,该设置无效;部分机型横屏模式不能占用安全区)

5.1.6以下引擎版本发布原生工程

5.1.6以下引擎没有支持发布原生工程的脚本不能通过launcher直接发布原生工程。

解决方案

  1. 通过launcher创建引擎版本为5.1.6或以上的egret工程创建原生工程。
  2. 将需要打包原生应用的游戏发布为h5版本。
  3. 将发布结果替换到原生工程的assets/game目录下。

注意

Native 仅支持 webgl 渲染模式。