Skip to content

基础使用文档(中文)

Rainy edited this page Jul 19, 2022 · 5 revisions

zyheaps

这是一个基于heaps引擎之上的简化版api。旨意让它拥有可用的Android/IOS/Mac/Window/HTML5/小游戏等平台开箱即用的能力。

记录问题

当前状态是开放中,会存在大量问题需要解决。

开发安装

haxelib git zyheaps https://github.com/rainyt/zyheaps.git

项目基础配置

需要在项目根目录下,建立一个zyheaps.xml文件,它跟openfl的project.xml功能相似。但功能还未完全实现。它基于https://github.com/jgranick/lime-tools实现。一个基础的配置:

<project>
    <meta title="ILandes" package="com.sample.ilandes" version="1.0.0" company="Company Name" />
    <!-- 指定类型 -->
    <app main="Main" path="Export" file="ILandes"/>
    <!-- 指定资源目录 -->
    <assets path="Assets" rename="assets" />
    <!-- 指定库 -->
    <haxelib name="zyheaps" />
    <haxelib name="heaps" />
    <!-- 指定源码位置 -->
    <source name="src" />
    <!-- 安卓配置 -->
    <define name="NDK_DIR" value="/Users/xxxxxx/Documents/SDK/android-ndk-r18b" />
    <define name="ANDROID_SDK_DIR" value="/Users/xxxxxx/Library/Android/sdk" />
    <define name="NDK_VERSION" value="18.1.5063045" />
</project>

HTML5目标(HTML5)

使用HTML5目标时,编译可使用:

haxelib run zyheaps build html5

当需要测试HTML5目标时:

haxelib run zyheaps test html5

压缩HTML5目标时:

haxelib run zyheaps test html5 -final

安卓目标(Android)

编译安卓时,需要配置好对应的NDK版本号:

<!-- NDK目录 -->
<define name="NDK_DIR" value=""/>
<!-- Android SDK目录 -->
<define name="ANDROID_SDK_DIR" value=""/>
<!-- NDK版本 -->
<define name="NDK_VERSION" value=""/>

再通过以下命令进行快速编译:

haxelib run zyheaps build android

NDK版本建议直接使用android-ndk-r18b

IOS目标(IOS)

编译IOS时,需要通过下述命令将XCode项目构造:

haxelib run zyheaps build ios

之后,再打开XCode项目,在XCode中进行编译。

Mac目标(Mac)

当前Mac目标暂时是Bate版本,不确定可行性,使用:

haxelib run zyheaps build mac

Window目标(Window)

目标是默认是SDL作为默认渲染器,使用:

haxelib run zyheaps build window

当需要使用directx作为渲染器,请在xml配置添加:

<define name="dx"/>

微信小游戏

它支持微信小游戏,编译时使用:

haxelib run zyheaps build wechat