HTML5游戏引擎（三）-第四章 Egret项目文件目录——入口文件-index.html & web桌面runtime移动 & 项目配置文件egretProperties.json

HTML5游戏引擎（三）-第四章 Egret项目文件目录——入口文件-index.html & web桌面runtime移动 & 项目配置文件egretProperties.json

第四章 Egret项目配置

1、Egret项目-文件目录

2、入口文件说明

index.html 为项目的入口文件，下面是 body 标签里的默认配置，您可以根据项目需求修改。

<div style="margin: auto;width: 100%;height: 100%;" class="egret-player"
         data-entry-class="Main"
         data-orientation="auto"
         data-scale-mode="showAll"
         data-frame-rate="30"
         data-content-width="640"
         data-content-height="1136"
         data-multi-fingered="2"
         data-show-fps="false" data-show-log="false"
         data-show-fps-style="x:0,y:0,size:12,textColor:0xffffff,bgAlpha:0.9">
</div>

• data-entry-class：文件类名称。
• data-orientation：旋转模式。
• data-scale-mode：适配模式。
• data-frame-rate：帧频数。
• data-content-width：游戏内舞台的宽。
• data-content-height：游戏内舞台的高。
• data-multi-fingered：多指最大数量。
• data-show-fps：是否显示 fps 帧频信息。
• data-show-log：是否显示 egret.log 的输出信息。

在 script 标签内，有项目的启动参数,如下图所示

egret.runEgret({ renderMode: "webgl", audioType: 0, 
calculateCanvasScaleFactor:function(context) {
    var backingStore = context.backingStorePixelRatio ||
        context.webkitBackingStorePixelRatio ||
        context.mozBackingStorePixelRatio ||
        context.msBackingStorePixelRatio ||
        context.oBackingStorePixelRatio ||
        context.backingStorePixelRatio || 1;
    return (window.devicePixelRatio || 1) / backingStore;
}});

参数是一个对象，包括以下3个可选属性：

• “renderMode”: 引擎渲染模式，”canvas” 或者 “webgl”
• “audioType”: 使用的音频类型，0:默认，2:web audio，3:audio。
• “calculateCanvasScaleFactor”：屏幕的物理像素适配方法，使用默认的即可

3、入口文件模板

web

如果您项目的配置文件 egretProperties.json 里有 template 字段，那么发布 Html5 项目时，就会使用 template/web/index.html 来作为入口文件。
例如：

{  "engineVersion": "5.2.9",  "compilerVersion": "5.2.9",  "template": {}, //该字段只要存在，  //就会使用 template/web/index.html 来作为入口文件。  ... }

runtime

发布原生项目的配置文件

4、项目配置文件说明

项目的根文件夹下有名为 egretProperties.json 的配置文件，引擎所涉及的配置均存储在此。

{
  "engineVersion": "5.2.25",
  "compilerVersion": "5.2.25",
  "template": {},
  "target": {
    "current": "web"
  },
  "modules": [
    {
      "name": "egret"
    },
    {
      "name": "eui"
    },
    {
      "name": "assetsmanager"
    },
    {
      "name": "tween"
    },
    {
      "name": "promise"
    }
  ]
}

engineVersion 字段

项目当前用来运行游戏的 egret 引擎版本，

compilerVersion 字段

项目当前使用的 egret 命令行版本，比如执行 build,publish 等命令，每个版本略有不同

template 字段

如果存在该字段，在发布 Html5 项目时，会使用 template/web/index.html 来作为入口文件。

target字段

执行 build 和 publish 命令时的目标类型。

• web：会编译成 Html5 项目
• wxgame：会编译成微信小游戏项目
• bricks：会编译 QQ 玩一玩项目
• android：会编译成安卓项目
• iOS：会编译成 iOS 项目

module 字段

定义项目中引用的所有库文件。
每一个库都是形如 { "name":"moduleName" , "path":"modulePath"} 的配置信息。
name 字段是库名。path 字段是库文件存放路径，如果没有此字段，取默认值${EGRET_DEFAULT}

  "modules": [
    {
      "name": "egret"
    },
    {
      "name": "eui"
    },
    {
      "name": "assetsmanager"
    },
    {
      "name": "tween"
    },
    {
      "name": "promise"
    }
  ]

内置库，主要包括:

• egret 引擎核心库
• egret3d 引擎 3D 库
• assetsmanager 资源管理模块
• dragonBones 龙骨
• eui UI 组件库
• game 游戏库
• media 多媒体库
• socket websocket 网络通讯库
• tween 缓动动画库
  擎核心库
• egret3d 引擎 3D 库
• assetsmanager 资源管理模块
• dragonBones 龙骨
• eui UI 组件库
• game 游戏库
• media 多媒体库
• socket websocket 网络通讯库
• tween 缓动动画库