Haxegon은 Haxe 프로그래밍을 위한 라이브러리로, OpenFL 및 Starling 기술 스택을 활용하여 게임 개발 과정을 간소화하고 초보자에게 친숙한 경험을 제공하도록 설계되었습니다. 이 튜토리얼에서는 Haxegon의 기본 구조를 살펴보고 첫 프로젝트를 시작하는 방법을 안내합니다.

1. 프로젝트 디렉토리 구조 및 설명

Haxegon 저장소는 특정 조직 구조를 따릅니다. 개발자 습관에 따라 프로젝트마다 다를 수 있지만, 핵심 라이브러리는 일반적으로 다음과 같은 부분들을 포함합니다:

• src: Haxegon 프레임워크의 핵심 클래스를 포함한 주요 소스 코드가 위치하는 곳입니다.
• templates/project: 새 프로젝트를 빠르게 시작할 수 있는 빈 프로젝트 템플릿을 제공합니다.
• .gitignore: Git이 버전 관리 중에 무시해야 하는 파일 유형 또는 경로를 지정합니다.
• LICENSE: 프로젝트에서 채택한 MIT 라이선스에 대한 자세한 내용입니다.
• haxelib.json: 이 파일에는 라이브러리에 대한 정보가 포함되어 Haxelib을 통해 관리할 수 있게 합니다.
• include.xml: 컴파일 시 특정 옵션을 구성하는 데 사용될 수 있습니다.
• README.md: 프로젝트 요약, 설치 단계 및 빠른 시작 가이드가 포함되어 있습니다.

2. 프로젝트 진입점 파일 소개

Haxegon을 사용하여 개발할 때, 주요 진입점은 일반적으로 제공된 빈 프로젝트 템플릿을 기반으로 생성된 새 프로젝트의 메인 파일입니다. 구체적인 위치는 프로젝트마다 다를 수 있지만, 일반적으로 프로젝트의 src 디렉토리에 있으며, 예를 들어 Main.hx라는 파일일 수 있습니다. 이 파일은 Haxegon 환경을 초기화하고, 게임 루프를 설정하며, 게임의 주요 로직을 호출하는 역할을 합니다. 기본적인 Main.hx 예시는 다음과 같을 수 있습니다:

package;

import haxegon.Haxegon;

class Main extends Haxegon {
    override function init():Void {
        // 게임 초기화 로직을 여기에 작성합니다.
    }
    
    override function update():Void {
        // 게임 업데이트 로직을 처리합니다.
    }
    
    override function draw():Void {
        // 렌더링 로직을 구현합니다.
    }
}

3. 프로젝트 구성 파일 설명

Haxelib.json

핵심 파일: haxelib.json은 라이브러리 이름, 버전, 종속성 등 라이브러리의 기본 정보를 정의하는 중요한 구성 파일입니다. 이는 Haxelib을 통한 관리 및 설치를 용이하게 합니다.

기타 구성

실제 프로젝트에서는 위에 언급된 haxelib.json 외에도 빌드 관련 구성 파일, 예를 들어 컴파일 매개변수, 대상 플랫폼 등을 지정하는 .hxml 파일을 접할 수 있습니다. 그러나 Haxegon 저장소 자체에서 직접 제공하는 내용에서는 이러한 세부 사항이 haxelib.json만큼 명확하게 보이지는 않습니다. 특정 프로젝트의 상세 컴파일 구성은 일반적으로 개발자가 프로젝트 루트 디렉토리에 사용자 정의 .hxml 파일을 만들어 컴파일 프로세스를 제어합니다.

Haxegon 시작하기

프로젝트를 신속하게 시작하려면 먼저 OpenFL이 설치되었는지 확인한 다음, Haxelib을 통해 Haxegon 라이브러리를 설치하십시오:

haxelib install haxegon

그런 다음 제공된 빈 프로젝트 템플릿을 활용하여 게임 개발 여정을 시작할 수 있습니다.

이것은 Haxegon 프로젝트의 기본 구조, 시작 파일 및 관련 구성에 대한 간략한 소개이며, 이 프레임워크를 빠르게 시작하는 데 도움이 되기를 바랍니다.