egret-docs-master

5.3 KiB

Raw Blame History

title
如何发布微端项目

什么是微端

白鹭微端是 Egret 团队为了解决原生 APP 包体过大而推出的打包解决方案。

通过动态加载技术，白鹭微端可保证打包发布的原生 APP 包体极小，以便节省游戏推广成本，提高游戏用户留存率。

白鹭微端内置两种运行模式，Runtime 模式下可大幅度提升基于 Egret 引擎所研发的游戏性能，而 Webview 模式可以最大化保证兼容性，支持其他不同游戏引擎所开发的 HTML5 游戏。

微端仅支持发布Android工程。

创建微端工程

进入微端界面

注册游戏，填写游戏名称和地址

创建Android工程，填写应用报名和应用名称

根据需求选择是否使用Runtime加速，如果没有勾选，将通过WebView加载游戏，两种模式的优缺点如下：

使用本地资源

微端使用的资源默认从网络加载，从 v0.0.13 版本开始，可以将资源打包在 app 中。

使用本地资源或想要把H5游戏打包到微端里，只需将h5发布的项目直接拷贝到 assets/game 目录，如没有这个目录请创建。

JS与Java通信

逻辑和Android Native相同，只是原生工程的API不同。

注册接收消息的方法：

launcher.setExternalInterface("sendToNative", new INativePlayer.INativeInterface() {
    @Override
    public void callback(String s) {
        Log.d("Egret Launcher", s);
    }
});

发送消息：

launcher.callExternalInterface("sendToJS", "message from microclient");

启动页

手动关闭启动页的方法

当打开游戏页面以后，微端默认自动关闭启动页。但此时您的页面里加载的js文件或者其他文件很多的时候，因为需要从网络或本地缓存里读取这些文件，会存在一段黑屏时间。对玩家来说用户体验不好。

所以我们也提供了一种手动关闭启动页的方法。这种模式下，启动页会一直存在，直到调用了关闭启动页的代码。

设置安卓工程

安卓工程的 MainActivity 里

//1 是自动关闭  0 是手动关闭
launcher.closeLoadingViewAutomatically = 1;

将代码里的 =1 改为 =0

修改游戏代码

当你的游戏初始化完成，可以关闭启动页时，调用下面这段代码

if (window['closeLoadingView']) {
    window['closeLoadingView']();
}

优化建议

黑屏等待的时间和加载文件的数量是成正比的，即便使用手动关闭启动页，也会让玩家等待很长时间。所以建议合并js数量，比如使用 egret publish 后的版本，可以把数百个js文件合并成一个，这样启动速度就会很快了。

禁用启动页的方法

微端0.1.8添加。禁用后将不再弹出启动页。

launcher.disableLaunchPage();

修改启动页地址的方法

微端0.1.8添加。

launcher.launchPageUrl = "启动页地址";

在微端中使用启动图

在应用启动之前，为了解决白屏体验不好的问题，一般会先显示一张图片，等应用启动后再关掉这个图片。微端中也有这个方法。

示例demo下载地址

启动图的意义

启动图可以减少用户看到的黑屏、白屏或者花屏的可能性，是 APP 的启动流程更加的自然，给用户带来更好的体验。

启动图的使用方法

通过 NativeLauncher 类的 initViews 方法启用启动图功能，函数原型如下：

public void initViews(FrameLayout layout, int imageResId, int duration);

其中，layout 表示 View 的根节点，imageResId 表示启动图的图片资源 id，duration 表示启动图展示的时间，单位为毫秒。如果该时间等于 0，则表示启动图启动图会在游戏启动后自行关闭，如果大于 0，则表示启动图会在到达该时间之后关闭。

举例来说，假设 res 文件夹下面的 drawable 目录下有一个名为 background.jpg 的图片，该图片被用于启动图并且启动图的展示时间为 2 秒，那么示例代码如下：

launcher.initViews(rootLayout, R.drawable.background, 2000);

其中，launcher 来自于 NativeLauncher 类，rootLayout 是 View 的根节点，R.drawable.background 指向前面的 background.jpg 图片，2000 表示展示时间为 2 秒。

其它工程设置

是否每次启动都重新下载游戏

使用这个功能是为了方便调试。默认值为0，设置为1后每次启动前都会清空下载缓存。

launcher.clearGameCache = 0;

加载index的超时时间

设置加载index的超时时间。默认值为-1，不设置超时。

launcher.loadingTimeout = -1;

设置预加载路径

详见“热更新方案说明”

launcher.preloadPath = "";

禁用原生渲染加速

如果引擎的版本合适，runtime会自动开启原生渲染加速。如果您不想使用该功能，可以在工程中关闭。

launcher.disableNativeRender();

设置webview透明

在 setExternalInterfaces(); 下面增加一行代码：

launcher.setWebViewBackgroundTransparent(true);

5.3 KiB Raw Blame History Unescape Escape