기본 콘텐츠로 건너뛰기

Dodge The Creep - [1]

Dodge The Creep - [1] 환경 설정

Godot 공식 문서에 나와있는 2D 튜토리얼인 Dodge The Creep 게임을 Rust를 이용해서 따라 만들어 보자.

템플릿 복사 및 실행

우선 프로젝트 셋업을 해야 한다. 이 부분은 Rust를 이용한다고 해도 크게 바뀌는 부분은 없다. 하지만, GDScript를 이용한다면, Godot Editor를 이용해서 처음부터 하면 되겠지만, Rust를 이용하기 때문에 우선 cargo를 이용해 기본 프로젝트 template를 만들고 난 후, 생성된 godot 폴더에서 프로젝트 설정을 수정하도록 한다.

$ cargo generate --git https://github.com/godot-rust/godot-rust-template --name dodge-the-creep-rust
$ cd dodge-the-creep-rust
$ cargo make run
cs

위 명령들을 하나씩 살펴보면,
  • cargo generate 를 이용해서 기본 템플릿을 이용한 프로젝트 폴더를 생성한다.
  • 만들어진 프로젝트 폴더로 이동
  • cargo make run 명령을 이용해 빌드 및 실행
cargo generate  를 이용해 프로젝트를 생성했을 때, 기존 템플릿은 make를 이용했기 때문에, gdnative 문서 페이지를 보면 make run  으로 빌드 및 실행 명령어가 안내되어 있지만, 최근 cargo build를 이용하는 방식으로 변경이 되어서 이제는 cargo make run 을 이용해서 실행해야 빌드 및 실행이 적절하게 동작 한다.

기존에는 비어있는 화면 이었는데, 최근 커밋에는 기본으로 spinning cube 가 동작하도록 되어 있어서 최신 소스 기반으로 실행을 한다면 아래의 하면을 볼 수 있다.

실행 화면 (기본으로 들어 있는 Spinning Cube)

로그가 나오고 있는 터미널

여기까지 동작이 되었다면, 일단 정상적으로 프로젝트 템플릿이 복사되었다는 것을 확인 할 수 있다. 이제, 개발을 위한 설정을 조금 더 진행 해 보자.

개발 환경 설정

이제 개발환경을 설정 할 시간이다. 프로젝트 폴더의 rust 폴더로 이동한 후, code . 명령을 이용해서 VSCode 를 실행 시키자.

dependency 설정 변경

최근 gdnative 버젼이 0.10.0 으로 변경이 되면서, cargo.toml 파일에서 권장하는 설정이 변경 되었다. 다음과 같이 공식 문서에서 권장하는 설정으로 cargo.toml file을 변경한다.

[dependencies]
gdnative = "0.10"
 
[lib]
crate-type = ["cdylib"]
cs

프로젝트 파일 생성 및 수정

우선 godot-rust 확장을 이용해서 프로젝트 파일을 생성한다. godot-rust 확장을 설치하고 이를 애용해서 프로젝트 파일을 생성하는 방법은 이전 포스트를 참고하면 된다. 여기서, 문제가 되는 부분은 위에서 템플릿을 실행할 때도 발생했는데 최근 빌드 방식 변경으로 인해 make 가 아닌 cargo build를 해야 한다는 사실이다. 하지만 아직까지 godot-rust 확장에 이 부분이 적용되지 않아서 기존 make 방식으로 커멘드들이 적용되어 있어서 이부분을 수정해 줘야 한다.

task.json 수정

task.json 파일을 열면, 이 프로젝트에서 실행할 수 있는 task들이 정의되어 있다. 이 중 build 관련된 부분의 명령어를 수정해 주면 된다. Build debug, Build Release, Clean 항목에서 command: "make build-${config:godot-rust.build.targetPlatform}-......"  와 같은 명령어 실행이 정의되어 있는 부분이 보이는데, make 앞 부분에 cargo 명령을 추가 해 주면 된다. 

아래는 Build Debug 항목을 수정 한 예 이다.
"command": "cargo make build-${config:godot-rust.build.targetPlatform}-debug",

cs

이렇게 수정한 후, task를 수행 하거나 F5를 눌러 디버깅을 수행 할 수 있다.

launch.json 수정

디버깅을 수행할 때 간혹 디버깅 포인트가 실제로 디버깅할 때 잡히지 않는 경우가 있었다. 이런 경우엔 디버거 타입을 lldb 에서 cppdbg 로 변경해 보길 바란다.

{
"version": "0.2.0",
"configurations": [
{
"name": "Debug Game",
"preLaunchTask": "godot-rust: Build Debug",
"type": "cppdbg", //<- here
"request": "launch",
"program": "${config:godot-rust.environment.godotEditorPath}",
"cwd": "${config:godot-rust.environment.godotProjectPath}",
"presentation": {
"group": "Debug",
"order": 1
}
},
cs

이제, Dodge The Creep을 Rust로 만들어 볼 준비를 모두 마쳤다.





댓글

이 블로그의 인기 게시물

Godot-Rust 개발환경 설정

Godot-Rust 개발환경 설정 우선은 개발환경을 설치해 보면서 하나씩 배워보면 좋을 것 이다. 공식 홈페이지에 Godot 과 Rust 개발환경을 설정하는 방법이 자세히 나와있으니 각각 따라서 잘 설치하면 되지만, Godot과 Rust를 동시에 사용하기 위한 내용을 포함해 다시 정리해 본다. 앞선 게시물에서 Godot에서 C/C++ 바인딩을 위해 GDNative와 헤더를 제공한다고 적었는데, 이를 통해 Rust도 Godot과 바인딩해서 사용할 수 있다. 직접 GDNative와 바인딩 하는 것을 할 수도 있겠지만, 이미 godot-rust 오픈소스 프로젝트에서 안정적으로 바인딩된 상태이므로 이 프로젝트를 사용하면 다시 바인딩 할 필요없이 제공되는 gdnative crate를 사용함으로써 쉽게 Rust를 이용해 Godot 개발을 할 수 있다. Godot Engine Godot 공식 다운로드 페이지 에서 자신의 OS에 해당하는 이미지를 받아서 적절한 폴더(예들들어, ~/Godot/)를 만들고 집어 넣는다. 어느곳 에서도 실행 할 수 있도록, 환경변수에 path를 설정한다. The godot-rust Book  페이지에는 3.2.3-stable을 지원하고 있다고 되어 있는데, 이는 cargo의 dependency에 gdnative crate 버젼을 0.9.3 으로 명시했을때고, 그렇지 않고 github의 주소를 적으면, 3.4.2 (이 글을 작성하는 최신버전) 까지도 문제없이 동작한다. Rust rustup  을 방문하면, rust 에서 공식적으로 제공하는 설치 이미지를 통해 Rust toolcahin을 설치 할 수 있다. (Ubuntu인 경우 curl 을 통해 받아서 설치됨) 설치 후 다음과 같은 명령어를 통해 잘 설치 되었는지 확인할 수 있다. LLVM godot-rust 는 LLVM에 기반한 bindgen을 기반해 바인딩 되어 있기 때문에, LLVM 바이너리를 설치해야 한다. 설치 후 다음 명령을 통해 설치가 잘 되어 있는지 확인 할 수 있다....

Dodge The Creep - [2]

Dodge The Creep - [2] 템플릿 정리하기 Template 정리 본격적으로 tutorial 을 따라하기 전에 우선 프로젝트 설정을 위해 복사해 놓은 template code를 정리할 필요가 있다. 현재 이 template 코드에는 삼차원 큐브가 회전하고 있는 상태이고, rust code의 경우 이 글을 작성하고 있는 현재 시점에서는 에러를 포함하고 있기도 하다. Godot Project Godot 엔진 에디터를 시작해서, 만들어 놓은 프로젝트 폴더의 godot 폴더 안에 있는 project.godot 파일을 열어서 프로젝트를 로딩한다. 왼쪽 하단의 FileSystem 영역을 보면 폴더 구조로 resource들이 나열되어 있는데, res://scenes 아래에 Game.tscn과 SpinningCube.tscn 두개의 scene 파일이 들어 있는 것이 보일 것 이다.  여기서, SpinningCube.tscn은 불필요 하기 때문에 지운다. 그리고나서, Game.tscn 파일을 열어보면 왼쪽 상단 Scene 텝에 scene에 포함된 노드들이 보이는데, 루트노드는 Spatial 타입의 노드이고, 그 밑으로 Camera 와 SpinningCube 노드들이 붙어 있는 것이 보일 것 이다.  우선 Camera와 SpinningCube 노드들워준 후, Game 노드의 타입을 Node2D 타입으로 변경 해 준다. 이제 Godot project 의 정리는 완료 되었다. Rust project 이제 Rust project를 정리해 볼 차례다. 프로젝트 폴더 아래 rust 폴더를 VSCode로 열어보자. 왼쪽 파일 탐색기를 보면, src 폴더아래에 세개의 .rs 파일이 존재 하는 것을 볼 수 있다. 이 중, spinnig_cube.rs를 지우고, lib.rs 안에서 spinning_cube.rs 파일을 호출 하는 부분들을 지워주자. lib.rs 파일을 열면, spinnig_cube 모듈을 로딩 하는 부분과, Godot에 노출하는 클래스로 등록하는 부분...

[C#] 자동으로 특정 팝업창 닫기

[C#] 자동으로 특정 팝업창 닫기 Windows UI 테스트 혹은 자동화 작업을 할 때, 특정 윈도우창 혹은 팝업창이 뜨는 것을 인지 하고, 내용을 얻거나 버튼을 누르려면,  System.Windows.Automation 의 AddAutomationEventHandler 를 사용하면 된다. Hook 설정 4 번째 라인에서 WindowOpendEvent를 설정 함 으로써, 창이 열릴 때 hook이 걸린다. 7 번째 라인에서 event handler를 등록 한다. Event Handler 설정 8 번째 라인에서 element의 이름이 내가 찾는 이름인지 비교한다. 15번째 라인에서 팝업창의 내용을 출력 한다. 22번째 라인에서 팝업창의 자식 element중에 "N" 문자가 포함된 것 즉, 아니오 버튼을 찾는다. 24~25번째 라인에서 버튼을 누르는 동작을 수행 한다.