NME开源项目启动与配置教程

1. 项目的目录结构及介绍

NME项目的目录结构如下：

nme/
├── assets/             # 存放项目资源文件，如图片、音频、视频等
├── build/              # 构建输出目录
├── haxelib/            # Haxe库文件存放目录
├── libraries/          # 项目依赖的库文件
├── neko/               # NekoVM相关文件
├── ndll/               # Native Dynamic Link Libraries
├── nme/                # NME框架的核心代码
├── platforms/          # 不同平台（如iOS、Android）的特定代码和资源
├── src/                # 源代码目录，包含所有的Haxe代码
├── templates/          # 项目模板
└── toolchain/          # 工具链相关脚本和配置文件

• assets/：所有项目的资源文件都存放在这里，便于管理和引用。
• build/：构建项目时生成的文件会放在这个目录下。
• haxelib/：Haxe库文件存放的地方，用于存放项目所需的各种Haxe库。
• libraries/：存放项目依赖的库文件，这些库可能包括第三方库或自定义的库。
• neko/：与NekoVM相关的文件，NekoVM是一个开源的轻量级虚拟机。
• ndll/：存放不同平台所需的本地动态链接库。
• nme/：NME框架的核心代码，是项目能够运行的基础。
• platforms/：不同平台特有的代码和资源，比如特定于iOS或Android的代码。
• src/：所有Haxe语言的源代码都放在这里，是项目的核心开发区域。
• templates/：包含项目模板，可用于生成新的项目结构。
• toolchain/：包含构建和打包项目的工具链脚本和配置。

2. 项目的启动文件介绍

在src/目录下，通常会有一个名为Main.hx的文件，这是项目的启动文件。以下是Main.hx的基本结构：

package;

import nme.display.Sprite;
import nme.display.Stage;
import nme.events.Event;

class Main extends Sprite {
    public function new() {
        super();
        // 初始化代码
    }

    public function main():Void {
        // 启动项目的代码
        stage.addEventListener(Event.ADDED_TO_STAGE, onAddedToStage);
    }

    private function onAddedToStage(e:Event):Void {
        // 当舞台被添加到显示列表时调用的代码
    }
}

Main.hx文件定义了一个Main类，它继承自Sprite类。在Main类的构造函数中，通常会添加一些初始化的代码，并在main方法中启动项目。onAddedToStage方法会在舞台被添加到显示列表时被调用，这是设置舞台和开始项目交互的好地方。

3. 项目的配置文件介绍

NME项目的配置文件通常位于项目的根目录下，名为build.xml。该文件用于定义项目的构建过程，包括编译、打包等步骤。以下是一个build.xml文件的示例：

<project name="MyProject" default="build" basedir=".">
    <property name="haxe" location="path/to/haxe"/>
    <property name="neko" location="path/to/neko"/>
    <property name="nme" location="path/to/nme"/>

    <target name="build">
        <haxe fork="true" output="build/MyProject.swf" file="src/Main.hx" includes="nme" php="true">
            <define name="flash10_1"/>
            <define name="iphone"/>
        </haxe>
    </target>

    <target name="clean">
        <delete dir="build"/>
    </target>
</project>

在这个配置文件中，定义了两个目标（target）：

• build：这个目标使用Haxe编译器编译src/Main.hx文件，并生成一个SWF文件在build/目录下。这里还包括了一些定义，比如指定目标平台（如flash10_1和iphone）。
• clean：这个目标用于清理build/目录，删除所有构建输出。

通过修改build.xml文件，可以定制项目的构建过程，包括不同的编译选项、目标平台和其他构建步骤。