Attention: Here be dragons
This is the latest
(unstable) version of this documentation, which may document features
not available in or compatible with released stable versions of Godot.
Checking the stable version of the documentation...
Android 편집기 사용하기
2023년에 우리는 Android 기기에서 2D 및 3D 프로젝트를 만들고, 개발하고, 내보내는 데 사용할 수 있는 편집기의 Android 포트를 추가했습니다.
앱은 Godot 다운로드 페이지 또는 Google Play 스토어에서 다운로드할 수 있습니다.
참고
Android 편집기는 아직 초기 단계에 있으며, 앞으로도 우리는 경험을 지속적으로 개선해 나가고 있습니다. 아래 제한 사항 및 알려진 문제을 참조하세요.
Android 기기 지원
Android 편집기는 Android 5 Lollipop 이상을 실행하고 OpenGL 3 이상을 지원하는 기기가 필요합니다. 여기에는 다음 기기가 포함됩니다 (완전하지 않음):
Android 태블릿, 폴더블 및 대형폰
Android 제공 넷북
Android 앱을 지원하는 Chromebook
요구사항
모든 파일 액세스 권한: 편집기가 장치의 모든 파일 위치에서 프로젝트 파일을 생성하고, 가져오고, 읽을 수 있도록 합니다. 이 권한이 없으면 편집기는 계속 작동하지만 장치의 파일 및 디렉터리에 대한 액세스가 제한됩니다.
REQUEST_INSTALL_PACKAGES: 편집기에서 내보낸 프로젝트 APK를 설치할 수 있습니다.
RECORD_AUDIO: audio/driver/enable_input 프로젝트 설정이 활성화된 경우 요청됩니다.
팁과 요령
입력
최고의 경험과 높은 생산성을 위해서는 블루투스 키보드와 마우스를 연결하여 Android 편집기와 상호작용하는 것이 좋습니다. Android 편집기는 `일반적인 단축키 및 키 매핑 <https://docs.godotengine.org/en/stable/tutorials/editor/default_key_mapping.html>`__을 모두 지원합니다.
키보드 및 마우스와 상호 작용할 때 interface/touchscreen/increase_scrollbar_touch_area 편집기 설정을 사용하여 스크롤 막대의 크기를 줄일 수 있습니다.
2D 프로젝트의 경우 `블록 코딩 플러그인 <https://godotengine.org/asset-library/asset/3095>`__은 연결된 하드웨어 키보드가 없을 때 스크립트 구성에 대한 블록 기반 시각적 대안을 제공할 수 있습니다.
멀티 스레딩(Multi-threading)
소형 장치에서 PiP(Picture-in-Picture) 모드를 활성화하고 사용하면 편집기*와 *재생 창 간에 쉽게 전환할 수 있는 기능이 제공됩니다.
PiP는 run/window_placement/play_window_pip_mode 편집기 설정을 통해 활성화할 수 있습니다.
run/window_placement/android_window 편집기 설정을 사용하여 재생 창이 항상 PiP 모드에서 시작되어야 하는지 여부를 지정할 수 있습니다.
참고: PiP 모드에서는 재생 창에 입력 액세스 권한이 없습니다.
프로젝트 동기화
Git을 통한 프로젝트 동기화는 Android Git 클라이언트를 다운로드하여 수행할 수 있습니다. Git 및 SSH와 같은 일반적인 터미널 유틸리티에 대한 액세스를 제공하는 Android 터미널 에뮬레이터인 `Termux 터미널 <https://termux.dev/en/>`__을 권장합니다.
참고: Termux 터미널에서 Git을 사용하려면 터미널에 WRITE 권한을 부여해야 합니다. 이 작업은 터미널 내에서 다음 명령 <https://wiki.termux.com/wiki/Termux-setup-storage>`__을 실행하여 수행할 수 있습니다: ``termux-setup-storage`
플러그인
GDExtension 플러그인은 예상대로 작동하지만 플러그인 개발자가 네이티브 Android 바이너리를 제공해야 합니다.
제한 사항 및 알려진 문제
Android 편집기의 알려진 제한 사항과 문제는 다음과 같습니다.
C#/Mono 지원이 없습니다.
외부 스크립트 편집기를 위한 지원이 없습니다.
Forward+ 렌더러는 사용 가능하지만 심각한 성능 문제로 인해 권장되지 않습니다.
UX는 Android 휴대폰 폼 팩터에 최적화되지 않았습니다.
`Android Go 장치 <https://developer.android.com/guide/topics/androidgo>`__에는 장치 읽기/쓰기 액세스에 필요한 모든 파일 액세스 권한이 부족합니다. 해결 방법으로 Android Go 장치를 사용할 때 Android Documents 또는 Downloads 디렉터리에만 새 프로젝트를 만드는 것이 좋습니다.
삼성 키보드에는 스크립트를 쓸 때 임의 입력이 삽입되는 `bug <https://github.com/godotengine/godot/issues/70751>`__이 있습니다. 대신 `Google 키보드(Gboard) <https://play.google.com/store/apps/details?id=com.google.android.inputmethod.latin>`__를 사용하는 것이 좋습니다.
더 보기
알려진 버그의 목록에 대해서는 Android 편집기와 관련된 GitHub의 열린 이슈 목록을 참조하세요.