2026년 9월 16일 기준 Godot 공식 버전 보관소는 4.7.2를 안정 유지 버전으로 표시하고, 4.8-dev6은 개발 버전으로 구분합니다. 공식 버전 보관소와 Godot 4.7 iOS 내보내기 문서를 기준으로 보면 결론은 분명합니다. Godot 4.7 iOS 내보내기는 Xcode가 설치된 macOS 환경에서 완료해야 합니다. Windows와 Linux는 일상 개발에 계속 사용하고, iOS 내보내기와 서명은 원격 Mac 또는 별도 Mac 발행 노드로 넘기는 구성이 적합합니다.
마지막 업데이트: 2026년 9월 16일. Godot 공식 버전 보관소, iOS 내보내기 문서, Apple의 Xcode 및 앱 제출 문서를 다시 확인했습니다.
이 글은 Windows 또는 Linux에서 Godot 게임을 개발하는 팀을 위한 내용입니다.
또한 iOS 발행 작업을 분리하려는 빌드 엔지니어와, 원격 Mac 임대·구매·혼합 CI 중 하나를 결정해야 하는 기술 책임자를 대상으로 합니다.
[ SECTION_01 ] 도구 체인 경계
Godot 편집기에서 프로젝트를 열 수 있다는 사실은 iOS 납품이 끝났다는 뜻이 아닙니다. 개발 환경, 내보내기 템플릿, Xcode 프로젝트, 보관 파일, 최종 제출 산출물은 서로 다른 단계입니다.
Windows나 Linux에서 처리할 수 있는 작업은 장면 편집, GDScript 작성, 일반 자료 제작, 저장소 관리, 코드 검사입니다. 반면 iOS 내보내기 템플릿 실행, Xcode 빌드, Apple 서명, 보관 파일 생성과 앱 제출은 macOS 쪽에서 검증해야 합니다.
Godot 공식 문서는 iOS 프로젝트를 Xcode가 설치된 macOS 컴퓨터에서 내보내야 한다고 명시합니다. 따라서 Windows에서 Xcode 프로젝트 폴더가 생성되었거나 내보내기 디렉터리가 생겼다는 이유만으로 성공 판정을 내리면 안 됩니다.
Godot 4.7.2와 개발 버전인 4.8-dev6을 같은 기준으로 취급해서도 안 됩니다. 유지 버전은 고정하고, 개발 버전이나 미확인 플러그인은 별도 실험 대상으로 분리해야 합니다. 공식 내보내기 안내는 이 경계를 확인하는 첫 자료입니다.
[ SECTION_02 ] 환경 통제권
원격 Mac을 선택할 때 가장 먼저 확인할 항목은 화면 접속 여부가 아닙니다. 다음 작업을 실제로 수행할 수 있는지가 핵심입니다.
- 저장소에서 지정한 Godot 4.7 버전을 설치합니다.
- iOS 내보내기 템플릿을 같은 버전으로 준비합니다.
- 필요한 Xcode 구성 요소와 명령 줄 도구를 설치합니다.
xcode-select가 의도한 Xcode 경로를 가리키는지 확인합니다.- 셸에서 사용자 입력 없이 내보내기와 빌드를 실행합니다.
- 새 작업 공간에서도 같은 결과가 나오는지 확인합니다.
여기서 관리자 권한, 소프트웨어 설치 권한, 파일 보존 정책을 함께 확인해야 합니다. 편집기는 열리지만 지정한 템플릿을 설치할 수 없거나, Xcode 경로를 바꿀 수 없거나, 재시작 뒤 환경이 초기화된다면 생산 노드로 보기 어렵습니다.
특히 다음 조건이면 수정을 계속하기보다 중단하는 편이 낫습니다.
- Godot 버전을 고정할 수 없습니다.
- 내보내기 템플릿을 저장소 또는 별도 관리 위치에서 재현할 수 없습니다.
- Xcode 명령 줄 도구의 경로를 확인할 수 없습니다.
- 작업 공간이 재시작 때마다 사라집니다.
- 비대화형 명령에서 인증 창이나 권한 창이 멈춥니다.
이 기준에서 통제권이 부족한 임시 노드는 짧은 탐색에는 쓸 수 있어도 서명과 제출을 맡기기 어렵습니다. 장기 이용이 예상되면 NOVAKVM의 원격 Mac 환경처럼 접속 방식과 관리 범위를 먼저 확인한 뒤 시험 빌드를 진행해야 합니다.
[ SECTION_03 ] 서명 자산과 발행 책임
iOS 발행에서 “패키징”이라는 말은 여러 작업을 한데 묶어 버립니다. 실제로는 다음 요소를 각각 확인해야 합니다.
- Bundle ID
- 팀 식별자
- 개발 또는 배포 인증서
- 인증서의 개인 키
- 프로비저닝 프로파일
- Xcode 보관 파일
- 앱 제출 결과
자동 서명은 초기 설정을 단순하게 만들 수 있습니다. 그러나 계정 권한과 네트워크 상태에 영향을 받으며, 무인 실행에서 자격 증명 갱신이 멈출 수 있습니다. 수동 서명은 설정 항목이 많지만 어떤 인증서와 프로파일이 사용되었는지 기록하기 쉽습니다.
앱 본체와 확장 대상이 함께 있다면 각각의 서명 상태를 확인해야 합니다. 앱 본체만 정상이고 확장 대상이 다른 팀 식별자나 프로파일을 사용하면 Xcode 빌드가 실패할 수 있습니다. 저장소에는 자리 표시자만 두고, 인증서와 개인 키는 통제된 발행 노드의 비밀 변수 또는 안전한 자격 증명 저장소에서 주입하는 방식이 적합합니다.
Apple은 등록된 기기 배포와 제출 절차를 별도로 설명합니다. Xcode의 기기 배포 문서와 앱 제출 안내를 각각 확인해야 합니다. 2026년 9월 14일 Apple이 확인한 Xcode 27 및 대응 정식 SDK 제출 조건도 실제 발행 시점에 다시 대조해야 합니다. 특정 미리 보기 버전이 계속 허용된다고 가정해서는 안 됩니다.
[ SECTION_04 ] 테스트 증거
내보내기 폴더가 생겼다는 결과만으로는 부족합니다. 실제 Godot 프로젝트를 사용해 다음 순서로 증거를 남겨야 합니다.
- 깨끗한 작업 공간에서 저장소를 내려받습니다.
- Godot 버전과 내보내기 템플릿을 확인합니다.
- iOS 프로젝트를 내보내 Xcode 프로젝트를 생성합니다.
- Xcode에서 대상 SDK와 서명 설정을 확인합니다.
- 보관 파일 또는 테스트 빌드를 생성합니다.
- 로그, 산출물 이름, 커밋 식별자를 보관합니다.
- 재시작 뒤 같은 작업을 다시 수행합니다.
Apple의 시뮬레이터 및 실제 기기 실행 설명에 따라 검증 범위를 나눠야 합니다.
Apple Silicon Mac에서 앱이 실행된다는 사실은 Mac 쪽 실행 가능성을 보여 줍니다. iOS 시뮬레이터는 화면 흐름과 일부 입력, 기본 동작을 확인하는 데 유용합니다. 실제 iPhone 또는 iPad 테스트는 기기 입력, 그래픽 동작, 권한, 플랫폼 서비스와 같은 위험을 더 직접적으로 확인합니다. 어느 하나도 다른 두 검증을 완전히 대신하지 않습니다.
플러그인, 네이티브 확장, 터치 입력, 그래픽 셰이더, 알림과 결제 같은 플랫폼 기능이 있다면 시뮬레이터만으로 합격 판정을 내려서는 안 됩니다. 프로젝트 위험이 낮으면 시뮬레이터와 제한된 기기 검증으로 시작할 수 있지만, 발행 직전에는 목표 기기와 목표 서명 방식으로 확인해야 합니다.
[ SECTION_05 ] 자동화와 복구
Godot 명령 줄 내보내기와 Xcode 후속 빌드는 하나의 무인 작업으로 연결할 수 있습니다. Godot 명령 줄 내보내기 문서를 기준으로 내보내기 명령을 고정하고, GitHub Actions의 자체 관리 실행기 안내를 참고해 Mac 실행 노드의 등록과 제거 절차를 분리합니다.
자동화 단계에는 다음 검사가 포함되어야 합니다.
- 저장소 커밋과 Godot 버전 기록
- 내보내기 사전 설정과 비밀 변수 분리
- Xcode 경로와 서명 대상 확인
- 보관 파일 및 로그 저장
- 실패 뒤 작업 공간 정리
- SSH 연결이 끊겨도 프로세스가 유지되는지 확인
- Mac 재시작 뒤 실행기와 도구가 복구되는지 확인
SSH 세션이 살아 있다는 사실은 작업이 완료되었다는 뜻이 아닙니다. tmux 같은 세션 유지 도구를 사용하더라도 인증 실패, 디스크 부족, 작업 공간 오염을 별도로 감지해야 합니다.
단일 장기 노드는 구성이 쉽지만 장애가 모든 발행 작업으로 번집니다. 독립 발행 노드는 서명 자산을 격리하기 좋지만 관리 항목이 늘어납니다. 일반 노드와 Mac 노드를 나누는 혼합 구조는 범용 작업을 기존 환경에 남기고 Apple 전용 작업만 Mac으로 보내므로, 팀 규모가 커질수록 책임 범위를 나누기 쉽습니다.
[ SECTION_06 ] 자주 묻는 판단
Windows 개발물의 iOS 전환
Windows에서 완성한 Godot 프로젝트는 저장소와 내보내기 설정을 Mac으로 넘겨 처리합니다. 개발 컴퓨터를 바꿀 필요는 없습니다. 다만 Mac에서 생성한 Xcode 프로젝트가 실제로 빌드되고, 서명된 산출물이 목표 배포 경로에 맞는지까지 확인해야 합니다.
Xcode 구성 범위
Godot iOS 내보내기는 Xcode가 설치된 macOS 환경을 전제로 합니다. 단순히 일부 파일을 생성하는 단계와 Xcode 빌드, 보관, 제출 단계는 다릅니다. 따라서 발행 노드에는 프로젝트가 요구하는 Xcode 구성 요소와 명령 줄 도구를 고정하고, xcode-select 결과를 로그로 남겨야 합니다.
C# 프로젝트의 추가 확인
C# 프로젝트는 사용 중인 플러그인과 네이티브 코드에 따라 검증 범위가 달라질 수 있습니다. Godot 4.7 공식 문서에서 확인되지 않은 지원 상태를 일반 규칙으로 확대하면 안 됩니다. 실제 프로젝트로 내보내기, Xcode 빌드, 시뮬레이터와 기기 검증을 나눠 수행해야 합니다.
[ SECTION_07 ] 선택 점수와 비용 변수
아래 점수는 가격표가 아니라 의사결정용 편집 점수입니다. 5점에 가까울수록 해당 조건에 적합합니다. 실제 비용은 임대 기간, 환경 준비 시간, 유휴 시간, 대체 노드, 서명 관리, 운영 인건비를 합산해 계산해야 합니다.
| 선택지 | 단기 또는 불확실한 사용 | 지속적인 높은 사용 | 환경 통제권 | 운영 부담 | 적합한 판단 |
|---|---|---|---|---|---|
| 원격 Mac 임대 | 5점 | 3점 | 3점 | 2점 | 먼저 시험하고 빠르게 발행해야 할 때 |
| Mac 실물 구매 | 2점 | 5점 | 5점 | 4점 | 사용량이 안정적이고 직접 운영할 때 |
| 혼합 CI | 4점 | 5점 | 4점 | 4점 | 범용 작업과 Mac 발행을 분리할 때 |
단기 이식이나 발행 주기가 불확실하면 원격 Mac 임대가 먼저입니다. 팀이 실제 프로젝트로 템플릿, Xcode, 서명, 재시작 복구를 검증한 뒤 필요한 기간만 유지할 수 있기 때문입니다. 장기간 높은 이용률이 이어지고 장애 대응과 교체 장비를 직접 관리할 수 있다면 Mac 구매를 검토합니다.
반대로 일반 빌드가 많고 iOS 발행만 제한적으로 필요하면 혼합 CI가 적합합니다. Windows 또는 Linux 노드는 코드 검사와 범용 작업을 담당하고, Mac 노드는 iOS 내보내기와 Xcode 빌드, 서명, 제출만 담당합니다.
| 파이프라인 단계 | Windows 또는 Linux 노드 | Mac 발행 노드 | 통과 증거 |
|---|---|---|---|
| 코드와 자료 검사 | 담당 | 선택 | 검사 로그와 커밋 식별자 |
| Godot 프로젝트 내보내기 | 일반 대상만 담당 | iOS 대상 담당 | 내보내기 로그와 설정 기록 |
| Xcode 빌드 | 불가 | 담당 | 빌드 로그와 보관 파일 |
| 서명과 프로파일 | 불가 | 통제된 노드에서 담당 | 대상별 서명 상태 |
| 시뮬레이터 검증 | 불가 | 담당 | 실행 로그와 화면 흐름 |
| 실제 기기 검증 | 불가 | 연결된 기기에서 담당 | 기기별 테스트 기록 |
| 앱 제출 | 불가 | 권한이 있는 발행 노드 | 제출 결과와 산출물 보관 |
| 복구 검증 | 일반 노드 절차 | 재시작·오염·실패 복구 | 재실행 결과 |
[ SECTION_08 ] 최종 선택 기준
Godot 4.7 프로젝트의 일상 개발은 Windows나 Linux에 남겨도 됩니다. Mac이 필요한 지점은 iOS 내보내기, Xcode 빌드, Apple 서명, 보관 파일과 제출입니다. 이 경계를 분리하면 모든 개발자를 Mac으로 옮기지 않고도 iOS 발행 경로를 만들 수 있습니다.
현재 환경이 불투명한 공유 Mac이라면 버전 고정, 템플릿 보존, 비대화형 실행, 서명 자산 격리, 재시작 복구를 먼저 확인해야 합니다. 이 다섯 항목 중 하나라도 검증되지 않으면 생산 CI에 연결하지 않는 편이 안전합니다.
Windows 또는 Linux만으로 계속 처리하는 방식은 Xcode 빌드와 Apple 서명을 수행할 수 없고, 생성된 Xcode 프로젝트를 최종 산출물로 오해하기 쉽습니다. 반대로 Mac을 직접 구매하면 초기 지출뿐 아니라 상시 전원, 업데이트, 장애 교체, 자격 증명 관리와 운영 시간이 따라옵니다. 사용량이 들쭉날쭉한 팀에는 유휴 시간이 비용으로 남습니다.
따라서 먼저 실제 Godot 프로젝트를 NOVAKVM의 원격 Mac에서 되돌릴 수 있는 시험 빌드로 실행하는 방법이 현실적입니다. 내보내기 템플릿, Xcode 빌드, 서명, 재시작 복구가 모두 통과하면 사용 빈도에 맞춰 임대 기간을 정하고, 높은 이용률이 지속될 때만 Mac 구매나 전용 혼합 CI로 확장하는 순서가 안전합니다..macOS 전용 발행 환경이 필요한 경우에는 Mac 미니 임대 비용 판단 자료도 함께 비교할 수 있습니다.
자주 묻는 질문
Windows에서 만든 Godot 프로젝트를 iOS 앱으로 내보내려면 어떻게 해야 하나요?
Windows나 Linux에서는 장면, 코드, 리소스를 계속 개발할 수 있습니다. 그러나 iOS 내보내기 템플릿으로 Xcode 프로젝트를 만들고 실제 앱을 빌드하려면 Xcode가 설치된 macOS 컴퓨터로 작업을 넘겨야 합니다. 원격 Mac에서는 저장소를 내려받고 버전을 고정한 뒤 내보내기, Xcode 빌드, 서명, 산출물 보관을 차례로 검증합니다.
Godot iOS 빌드에 전체 Xcode 설치가 필요한가요?
Godot 공식 문서는 iOS 프로젝트 내보내기를 Xcode가 설치된 macOS 컴퓨터에서 수행하도록 안내합니다. 단순히 내보내기 폴더가 생기는지만 확인해서는 부족합니다. 대상 SDK와 명령 줄 도구가 준비되어 있고 Xcode 프로젝트가 실제로 빌드되는지까지 확인해야 하므로, 발행 노드에는 필요한 Xcode 구성 요소를 고정해야 합니다.
원격 Mac에서 Godot iOS 서명과 앱 스토어 제출을 모두 처리할 수 있나요?
가능합니다. 다만 원격 Mac이 Bundle ID, 팀 식별자, 인증서, 프로비저닝 프로파일을 사용할 권한을 가져야 합니다. 개인 키와 배포 자격 증명은 일반 개발 노드와 분리된 통제된 발행 노드에 두는 편이 안전합니다. 제출 전에는 보관 파일과 실제 업로드 결과를 별도로 기록해야 합니다.
Godot iOS CI는 전부 Mac에 두는 편이 좋은가요?
전부 Mac에 둘 필요는 없습니다. 코드 검사, 일반 자료 처리, 다른 플랫폼 빌드는 기존 Windows나 Linux 노드에서 처리하고, Godot iOS 내보내기와 Xcode 빌드, 서명, 제출만 Mac 노드로 보내는 혼합 구성이 비용과 장애 범위를 줄이기 쉽습니다. 단, Mac 노드의 도구 버전과 복구 절차는 별도로 관리해야 합니다.
Godot C# 프로젝트의 iOS 내보내기에는 어떤 제한이 있나요?
C# 프로젝트는 일반 GDScript 프로젝트와 같은 방식으로 단정해서는 안 됩니다. Godot 4.7 공식 문서의 언어별 지원 상태와 프로젝트가 사용하는 플러그인, 네이티브 확장을 각각 확인해야 합니다. 먼저 실제 저장소를 대상으로 iOS 내보내기와 Xcode 빌드를 수행하고, 지원되지 않는 기능이나 플러그인이 있는지 실패 로그로 판별해야 합니다.