Unity 6.5 iOS 빌드 버튼이 회색으로 비활성화될 때 어떻게 해야 할까? 2026 초보자 해결법

과제 제출 직전인데 iOS 항목이나 빌드 버튼이 회색으로 보이나요? 먼저 Unity Hub에서 현재 Unity 6.5에 iOS Build Support가 설치됐는지 확인하고, 그다음 iOS Build Profile을 만들어 활성화하세요.

윈도우에서는 Xcode 프로젝트를 생성할 수 있어도 최종 빌드, 시뮬레이터 실행, 서명에는 호환되는 맥과 Xcode가 필요합니다.

이 글은 다음 사용자에게 맞습니다.

• 윈도우에서 처음 Unity 프로젝트를 iOS로 내보내는 학생
• 맥을 사용하지만 Build Profiles에서 iOS가 보이지 않는 초보자
• 과제 마감 전에 본체를 계속 고칠지, 잠시 원격 맥으로 옮길지 결정해야 하는 학습자

마지막 확인: 2026년 9월 20일. Unity 6.5 공식 안내, iOS 빌드 문서, Build Profiles 문서와 Xcode 시스템 요구 사항을 기준으로 정리했습니다. Unity Hub와 Xcode의 화면은 업데이트에 따라 달라질 수 있으므로, 아래 메뉴 이름은 실제 화면과 함께 대조해야 합니다.

회색 버튼의 위치부터 나누기

같은 “빌드가 안 된다”는 말이라도 원인은 다릅니다. Platform Browser에 iOS 자체가 없으면 모듈 문제일 가능성이 높습니다. iOS를 선택했지만 활성화되지 않으면 프로필 문제를 먼저 봐야 합니다. Build만 회색이면 프로젝트 설정이나 출력 대상이 원인일 수 있고, Build And Run만 회색이면 맥, Xcode, 기기 조건을 의심해야 합니다.

Unity 6.5의 변경 사항은 Unity 6.5 공식 안내에서 확인할 수 있습니다. 버전이 다른 편집기를 열어 놓고 모듈을 설치하면, 설치는 완료된 것처럼 보여도 현재 프로젝트에는 반영되지 않을 수 있습니다.

모듈이 없는 윈도우 편집기

Unity 편집기만 설치했다고 iOS 대상이 자동으로 추가되는 것은 아닙니다. iOS Build Support는 iOS용 프로젝트를 준비하는 별도 모듈입니다. Unity의 Platform Browser 공식 참고 문서에서도 플랫폼을 확인하는 화면과 상태를 구분해 설명합니다.

다음 순서로 확인합니다.

• [ ] Unity Hub를 열고 프로젝트가 사용하는 Unity 6.5 편집기 항목을 찾습니다.
• [ ] 해당 편집기의 추가 모듈 목록을 엽니다.
• [ ] iOS Build Support가 설치되어 있는지 확인합니다.
• [ ] 설치되지 않았다면 Unity Hub가 제공하는 공식 모듈만 선택합니다.
• [ ] 설치가 끝난 뒤 Unity 편집기를 완전히 종료하고 다시 엽니다.
• [ ] Platform Browser를 다시 열어 iOS 항목이 나타나는지 확인합니다.

이 단계의 합격 기준은 “설치가 끝났다는 알림”이 아닙니다. 편집기를 다시 연 뒤 Platform Browser에서 iOS를 실제로 선택할 수 있어야 합니다. 출처가 불분명한 독립 모듈이나 수정 스크립트는 사용하지 않는 편이 안전합니다.

주의: iOS Build Support를 추가했는데도 항목이 없으면 프로젝트를 재설치하기 전에 Unity Hub에서 선택한 편집기 버전이 현재 프로젝트의 버전과 같은지 확인하세요. 다른 버전에 모듈을 설치한 경우가 자주 섞입니다.

활성 빌드 프로필과 프로젝트 설정

iOS가 보이는데도 Unity 6.5 iOS 빌드 버튼이 회색이라면 Build Profiles를 확인합니다. Build Profile은 “이 과제를 어느 플랫폼용으로 만들지 적어 둔 작업 설정표”라고 생각하면 됩니다. Build Profile 생성 안내에 따라 iOS 프로필을 만든 뒤 Switch Profile로 현재 설정에 지정해야 합니다.

설정 순서는 다음과 같습니다.

1. Build Profiles 화면에서 새 프로필을 추가합니다.
2. 대상 플랫폼으로 iOS를 지정합니다.
3. iOS 프로필을 저장합니다.
4. Switch Profile을 사용해 해당 프로필을 활성 상태로 만듭니다.
5. 수업에서 사용하는 장면이 빌드 목록에 들어 있는지 확인합니다.
6. 애플리케이션 식별자가 비어 있거나 임시 값으로 남아 있지 않은지 확인합니다.
7. Build를 눌러 출력 폴더를 선택할 수 있는지 확인합니다.

애플리케이션 식별자는 앱을 구분하는 값입니다. Unity의 application identifier 공식 문서를 참고해 프로젝트의 식별자 형식을 확인하세요. 이 글에서는 배포 인증서나 앱 등록 절차까지 확장하지 않습니다. 목표는 먼저 Xcode 프로젝트가 생성되는지 확인하는 것입니다.

윈도우에서 끝나는 단계와 맥이 필요한 단계

윈도우에서 Unity 프로젝트를 만들고 스크립트를 작성하는 것은 계속할 수 있습니다. 다만 iOS 작업은 두 단계로 나뉩니다. Unity는 과제 파일을 정리해 Xcode 프로젝트라는 “제본 전 원고”를 만들고, Xcode는 맥에서 이를 컴파일하고 서명해 실행 가능한 앱으로 완성합니다.

Unity 공식 iOS 빌드 과정 문서는 Unity가 Xcode 프로젝트를 생성한 뒤 Xcode에서 최종 빌드를 진행하는 흐름을 설명합니다. 따라서 윈도우에서 Build가 성공했다는 사실만으로 시뮬레이터 실행이나 기기 테스트까지 끝났다고 보면 안 됩니다.

윈도우에서 Xcode 프로젝트까지 만들었는데 다음 단계가 막혔다면, 이는 Unity 오류가 아니라 운영 체제 경계일 수 있습니다. 관리자 권한 우회, 학교 장비 관리 해제, 공유 계정이나 인증서 사용은 해결책으로 삼지 마세요.

맥에서 Xcode와 실행 대상을 점검하기

맥으로 이동한 뒤에도 Build And Run이 되지 않는다면 Unity 버튼만 반복해서 누르지 말고 층을 나눠 확인해야 합니다. 먼저 Xcode가 설치되어 있는지, 현재 macOS와 목표 SDK 조합을 지원하는지 확인합니다. Xcode 27을 사용한다면 공식 시스템 요구 사항에서 해당 버전이 요구하는 macOS 조건을 직접 대조해야 합니다.

그다음 목표가 시뮬레이터인지 실제 기기인지 나눕니다.

• 시뮬레이터라면 선택한 기기와 런타임이 설치되어 있는지 확인합니다.
• 실제 기기라면 케이블 연결, 기기 신뢰, 개발자 계정과 서명 상태를 각각 확인합니다.
• Xcode 프로젝트가 열리는지 먼저 확인하고, 그다음 컴파일 오류를 읽습니다.
• Unity 스크립트 오류와 서명 오류를 같은 문제로 묶지 않습니다.
• 인증서 공유나 보안 확인 해제, 출처 불명의 수정 도구는 사용하지 않습니다.

경험상 구분법: Xcode 프로젝트 폴더가 생성되면 Unity의 내보내기 단계는 통과한 것입니다. 그 뒤 Xcode에서 멈추면 맥 환경, SDK, 서명 또는 프로젝트 코드 중 하나를 별도로 조사해야 합니다.

독립 FAQ

Unity 6.5에서 iOS 플랫폼이 보이지 않을 때

Unity Hub에서 현재 편집기와 같은 버전에 iOS Build Support가 설치됐는지 먼저 확인해야 합니다. 모듈이 없으면 Platform Browser에 iOS가 나타나지 않을 수 있습니다. 설치 뒤 편집기를 다시 열고 항목이 표시되는지 확인합니다.

iOS Build Support를 설치한 뒤에도 빌드가 안 될 때

모듈 설치와 활성 빌드 설정은 별개입니다. Build Profiles에서 iOS 프로필을 만든 뒤 Switch Profile로 지정해야 합니다. 장면 목록과 애플리케이션 식별자도 확인해야 하며, 프로필이 다른 플랫폼으로 남아 있으면 Build 명령이 비활성화될 수 있습니다.

윈도우에서 만들 수 있는 iOS 결과물

윈도우의 Unity는 Xcode 프로젝트를 내보내는 데 사용할 수 있습니다. 그러나 최종 앱 빌드, 시뮬레이터 실행, 서명과 기기 테스트는 호환되는 맥과 Xcode가 필요합니다. 윈도우에서 작업을 계속하되, 마지막 단계만 허가된 맥으로 옮기는 방식이 현실적입니다.

Build와 Build And Run이 모두 회색일 때

먼저 iOS Build Profile이 활성 상태인지 확인하고, 과제 장면과 식별자 설정을 점검합니다. Build까지 정상이라면 Xcode와 실행 대상의 문제로 범위를 좁힐 수 있습니다. 반대로 Build 자체가 회색이면 아직 Unity의 플랫폼 또는 프로젝트 설정 단계에서 멈춘 것입니다.

맥이 없을 때 과제를 마무리하는 방법

학교에서 허가한 맥을 빌리거나, 단기간 원격 맥을 사용해 Xcode 프로젝트 생성과 시뮬레이터 실행을 확인할 수 있습니다. 정식 프로젝트를 바로 옮기기보다 빈 Unity 프로젝트로 먼저 같은 과정을 검증하면 파일 문제와 환경 문제를 구분하기 쉽습니다.

마감 전 최종 결정

아래 항목을 모두 통과하면 본래 프로젝트로 넘어가도 됩니다.

• [ ] Unity Hub에서 현재 Unity 6.5 편집기의 iOS Build Support를 확인했습니다.
• [ ] Platform Browser에 iOS가 표시됩니다.
• [ ] iOS Build Profile을 만들고 활성화했습니다.
• [ ] 과제 장면이 빌드 목록에 들어 있습니다.
• [ ] 애플리케이션 식별자를 확인했습니다.
• [ ] 윈도우에서 Xcode 프로젝트 폴더가 생성됩니다.
• [ ] 맥에서 Xcode가 프로젝트를 엽니다.
• [ ] 목표가 시뮬레이터인지 실제 기기인지 결정했습니다.
• [ ] Xcode의 시스템 요구 사항과 현재 macOS를 대조했습니다.
• [ ] 서명이나 계정 문제를 코드 오류와 분리해 기록했습니다.

빈 프로젝트는 성공하지만 정식 프로젝트만 실패한다면 플러그인, 자원, 장면 설정을 비교하세요. 빈 프로젝트부터 Xcode 프로젝트 생성도 되지 않는다면 본체보다 환경 설정을 먼저 고치는 편이 빠릅니다.

현재 윈도우 환경은 Unity 제작과 Xcode 프로젝트 내보내기에는 쓸 수 있지만, 시뮬레이터와 최종 서명을 직접 처리할 수 없고 학교 컴퓨터는 설치 권한과 사용 시간이 제한될 수 있습니다. 반대로 단기 원격 맥은 물리 기기 연결이나 장기 고부하 작업에는 맞지 않을 수 있지만, 과제 마감 전 Xcode 확인과 시뮬레이터 실행만 필요할 때는 선택지가 됩니다. 먼저 KVMFLUX의 원격 맥 이용 안내에서 연결 조건을 확인하고, 빈 프로젝트로 환경을 검증한 뒤 필요할 때만 요금과 이용 기간을 비교하는 순서가 안전합니다.

Unity 프로젝트를 계속 윈도우에서 제작하면서 마지막 검증만 맥에서 해야 한다면, 파일 이동 방식과 Xcode 실행 가능 여부를 먼저 확인하세요. 이 조건이 맞지 않으면 대여보다 학교 맥이나 다른 허가된 환경이 더 적합합니다. 반대로 짧은 과제 기간 동안 맥이 없어서 제출 단계만 막힌 상황이라면, 전체 작업 환경을 바꾸기보다 원격 맥에서 빈 프로젝트와 정식 프로젝트를 차례로 검증하는 편이 시행착오를 줄일 수 있습니다.