명령 행(Command line) 튜토리얼

Some developers like using the command line extensively. Godot is designed to be friendly to them, so here are the steps for working entirely from the command line. Given the engine relies on almost no external libraries, initialization times are pretty fast, making it suitable for this workflow.

경로

It is recommended that your Godot binary be in your PATH environment variable, so it can be executed easily from any place by typing godot. You can do so on Linux by placing the Godot binary in /usr/local/bin and making sure it is called godot.

프로젝트 경로 설정하기

Godot 바이너리의 위치와 현재 작업 디렉토리의 위치에 따라, 다음 명령 중 하나가 제대로 작동하려면 프로젝트의 경로를 설정해야 합니다.

프로젝트의``project.godot`` 파일에 대한 경로를 다음과 같이 첫 번째 인자로 주면 됩니다:

[email protected]:~$ godot path_to_your_project/project.godot [other] [commands] [and] [args]

혹은 --path 인자를 사용합니다:

[email protected]:~$ godot --path path_to_your_project [other] [commands] [and] [args]

예를 들어, (아래에서 설명할) 게임을 내보내는 전체 명령은 다음과 같을 것입니다:

[email protected]:~$ godot --path path_to_your_project --export my_export_preset_name game.exe

프로젝트 생성하기

명령 행에서 프로젝트를 생성하려면 셸을 원하는 위치로 이동하고 project.godot 파일을 작성하십시오.

[email protected]:~$ mkdir newgame
[email protected]:~$ cd newgame
[email protected]:~/newgame$ touch project.godot

프로젝트는 이제 Godot로 열릴 수 있습니다.

에디터 실행하기

Running the editor is done by executing Godot with the -e flag. This must be done from within the project directory or a subdirectory, otherwise the command is ignored and the project manager appears.

[email protected]:~/newgame$ godot -e

씬을 만들고 저장한다면, 나중에 해당 씬을 인수로 사용하여 동일한 코드를 실행하여 편집할 수 있습니다.

[email protected]:~/newgame$ godot -e scene.tscn

씬 지우기

Godot는 당신의 파일 시스템과 친하고 추가적인 메타데이터 파일을 만들기 않을 것입니다. rm 을 사용해 씬 파일을 지웁니다. 참조하는 씬이 없다면 오류가 발생할 것입니다.

[email protected]:~/newgame$ rm scene.tscn

게임 실행하기

게임을 실행하려면, 간단히 프로젝트 디렉토리나 하위 디렉토리에서 Godot를 실행하면 됩니다.

[email protected]:~/newgame$ godot

특정 씬을 테스트 해야 하는 경우 씬을 명령 행으로 전달하십시오.

[email protected]:~/newgame$ godot scene.tscn

디버깅

Catching errors in the command line can be a difficult task because they just fly by. For this, a command line debugger is provided by adding -d. It works for running either the game or a simple scene.

[email protected]:~/newgame$ godot -d
[email protected]:~/newgame$ godot -d scene.tscn

내보내기(Exporting)

명령 행에서 프로젝트를 내보내는 것도 지원됩니다. 특히 연속적인 통합 설정에 유용합니다. 이 때문에 Godot의 헤드리스 버전은 (서버 빌드, 비디오 없음) 이상적입니다.

[email protected]:~/newgame$ godot --export "Linux X11" /var/builds/project
[email protected]:~/newgame$ godot --export Android /var/builds/project.apk

--export 스위치가 인식하는 플랫폼 이름은 에디터의 내보내기 마법사에 표시된 것과 동일합니다. 명령 행에서 지원하는 플랫폼 목록을 얻기 위해, 인지하지 않는 플랫폼으로 내보내기를 시도하고 그러면 구성이 지원되는 전체 플랫폼 목록이 나타날 것입니다.

게임의 디버그 버전을 내보내기 위해, --export 대신 --export-debug 스위치를 사용하세요. 매개 변수와 사용법은 동일합니다.

스크립트 실행하기

명령 행에서 .gd 스크립트를 간단하게 실행할 수 있습니다.특히 일괄 변환 또는 커스텀 가져 오기/내보내기를 위한, 큰 프로젝트에서 유용합니다.

스크립트는 SceneTree나 MainLoop에서 상속해야 합니다.

어떻게 작동하는 지의 예제입니다:

#sayhello.gd
extends SceneTree

func _init():
    print("Hello!")
    quit()

그리고 어떻게 실행하는 지의 예제입니다:

[email protected]:~/newgame$ godot -s sayhello.gd
Hello!

project.godot이 경로에 존재하지 않으면, 현재 경로는 (-path 가 지정되지 않는 한) 현재 작업 디렉토리로 가정합니다.