이번 주에는 Xcode 27 원격 Mac 프로젝트를 Git으로 기록하고, 원격 저장소에 올린 뒤, 별도 파일까지 복구해 열고 빌드해 보세요. 원격 Mac 안에만 저장하거나 동기화 표시만 확인하는 것으로는 과제를 되찾을 수 있다고 판단하기 어렵습니다.
이 안내는 Windows 컴퓨터로 원격 Mac에서 iOS 과제를 하는 학생에게 적합합니다.
SwiftUI 초보자나 제출이 가까운 학생이라면 코드뿐 아니라 이미지와 과제 자료도 함께 확인하세요.
SECTION 01 Xcode 27 원격 Mac 프로젝트 백업에서 자주 빠지는 것은 무엇인가요?
프로젝트 창이 열려 있다는 사실은 파일이 저장됐다는 증거가 아닙니다. 또 Git에 커밋한 기록이 있어도 원격 저장소에 푸시하지 않았다면 그 기록은 현재 Mac 안에만 남아 있을 수 있습니다. 백업 여부는 파일 위치, 원격 저장소 반영 여부, 복구 후 실행 가능성으로 나누어 판단하세요.
| 보관 방법 | 실제로 남기는 것 | 놓치기 쉬운 위험 | 확인할 점 |
|---|---|---|---|
| 원격 Mac의 프로젝트 폴더 | 현재 작업 파일 | 접속이 끊겨도 파일이 유지되는지는 이용 환경에 따라 다름 | 실제 저장 위치와 서비스의 보관 안내 |
| Git 원격 저장소 | 커밋한 변경 기록과 추적 파일 | 푸시하지 않은 커밋, 미추적 파일은 포함되지 않을 수 있음 | 최신 변경을 푸시했는지, 저장소 권한이 있는지 |
| iCloud Drive | 설정한 폴더의 동기화 파일 | 동기화는 별도 복구본을 보장하지 않으며 삭제가 다른 기기에도 반영될 수 있음 | 동기화 상태와 독립된 사본 유무 |
Git은 코드 변경을 기록하고 원격 저장소로 보낼 수 있습니다. 하지만 커밋은 작업 기록을 만드는 일이고, 푸시는 그 기록을 원격 저장소에 전달하는 일입니다. 두 동작은 같지 않습니다. Xcode의 소스 관리 설정 안내와 변경 사항 커밋 및 푸시 안내를 참고해 현재 프로젝트의 저장소 연결을 확인하세요.
원격 Mac 연결이 끊긴 뒤 프로젝트가 남아 있는지는 서비스의 저장 위치와 보관 규칙을 확인해야 합니다. 연결이 끊겼다는 사실만으로 파일이 삭제되거나 계속 보존된다고 단정하지 마세요.
SECTION 02 프로젝트가 원격 Mac에만 있거나 로컬 커밋만 있다면
Xcode 프로젝트는 화면에 표시되는 창이 아니라 실제 폴더와 그 안의 파일로 이루어집니다. 프로젝트가 어느 폴더에 저장되어 있는지 모르면, 먼저 Xcode에서 프로젝트 파일 위치를 확인한 다음 Finder에서도 해당 폴더를 찾아보세요. 프로젝트 파일과 폴더 관리 문서는 프로젝트 안의 파일을 관리하는 방법을 설명합니다.
다음 순서로 백업 상태를 점검하세요.
- 저장 위치 확인: Xcode에서 열려 있는 프로젝트의 폴더를 찾아 실제 파일이 있는지 확인합니다. 창을 닫기 전에 변경 내용을 저장하세요.
- Git 상태 확인: Xcode의 소스 제어 화면이나 터미널의
git status로 변경 파일과 미추적 파일을 살펴봅니다. Git 상태 명령 문서를 보면 어떤 파일이 아직 관리 대상에 들어오지 않았는지 확인하는 데 도움이 됩니다. - 커밋 만들기: 작업한 내용을 Git 기록에 저장합니다. Xcode의 소스 제어 기능을 사용한다면 현재 변경 사항이 커밋에 포함되는지 확인합니다.
- 원격 저장소로 푸시: 저장소 계정과 접근 권한을 확인한 뒤 푸시합니다. Git 푸시 문서에 나온 것처럼 푸시는 로컬 기록을 원격 저장소에 전달하는 동작입니다. 푸시가 끝났는지 저장소 화면에서도 확인하세요.
- 빠진 파일 별도 보관: 이미지, 수업에서 받은 자료, 데이터 파일처럼 Git에 포함되지 않은 항목이 있는지 확인하고 별도 사본을 둡니다.
- 복구 테스트: 깨끗한 폴더에 원격 저장소를 새로 복제하거나 보관한 사본을 열어 봅니다. Git 복제 문서에서 복제 동작을 확인할 수 있습니다. 필요한 파일이 보이고 과제에 필요한 빌드나 실행이 되는지 검사합니다.
| Git 상태 | 뜻 | 다음 행동 |
|---|---|---|
| 변경 내용은 보이지만 아직 커밋하지 않음 | 현재 작업이 기록으로 남지 않음 | 변경을 검토하고 커밋 |
| 커밋은 했지만 원격 저장소에서 확인되지 않음 | 기록이 원격에 전달되지 않았을 수 있음 | 푸시 결과와 저장소 권한 확인 |
| 미추적 파일이 표시됨 | 해당 파일이 Git 기록에 포함되지 않음 | 과제에 필요한 파일인지 판단하고 포함 또는 별도 보관 |
커밋만 해 둔 상태라면 원격 저장소에도 백업된 것으로 간주하지 마세요. Git 기록은 숙제 노트의 수정 기록과 비슷하고, 푸시는 그 기록을 다른 장소에 전달하는 단계입니다. 또 저장소에 올릴 파일을 고를 때 개인 계정 정보나 비밀 키는 공개 저장소에 넣지 마세요.
SECTION 03 Git 원격 저장소와 iCloud Drive를 함께 쓸 때
코드의 변경 이력은 Git 원격 저장소에 보관하고, Git에 포함하지 않은 수업 자료나 필요한 리소스는 별도 사본으로 관리하면 역할을 구분하기 쉽습니다. 다만 저장소에 올라갔다는 이유만으로 모든 파일이 포함됐다고 보기는 어렵습니다. Xcode 프로젝트에서 참조하는 이미지나 데이터가 실제 폴더에 있고, 복제한 프로젝트에서도 열리는지 확인하세요.
iCloud Drive는 파일을 기기 사이에서 동기화하는 기능이지, 삭제나 덮어쓰기에 대비한 독립 백업과 같지 않습니다. 안내에 따르면 iCloud Drive에서 파일을 삭제하면 같은 계정으로 연결된 다른 기기에도 변경이 반영될 수 있습니다. iCloud Drive의 데스크탑 및 문서 폴더 동기화 안내를 확인하고, 동기화 상태와 별도로 복구 가능한 사본을 보관하세요.
| 파일 종류 | 권장 확인 방법 | 주의할 점 |
|---|---|---|
| 소스 코드 | Git 상태를 확인하고 커밋한 뒤 푸시 | 커밋되지 않은 변경은 원격 저장소에 없을 수 있음 |
| 이미지와 과제 자료 | 프로젝트에서 실제로 열리는지 확인하고 별도 보관 | 파일만 빠져도 프로젝트가 열리거나 빌드되지 않을 수 있음 |
| 개인 설정과 비밀 정보 | 과제에 필요한지 판단하고 공개 저장소에서 제외 | 계정 비밀번호와 비밀 키를 코드에 넣지 않음 |
| 생성 파일과 빌드 결과 | 수업 제출 조건에 필요한지 확인 | 소스 파일과 다시 만들 수 있는 결과물을 구분 |
iCloud Drive의 동기화 표시만으로 복구 가능 여부를 판단하지 마세요. 다른 폴더나 저장소에서 실제로 열 수 있는 사본이 있어야 별도 복구 경로가 됩니다.
SECTION 04 복구한 프로젝트가 열리고 빌드되는지 확인하기
백업의 목적은 파일을 모으는 데 그치지 않습니다. 다른 위치에서 프로젝트를 다시 열어 과제에 필요한 상태로 사용할 수 있어야 합니다. 아래 확인을 제출 전에 진행하세요.
- 원격 저장소에 마지막 변경이 반영되었는지 확인합니다.
- 새 폴더에 프로젝트를 복제하거나 별도 보관본을 엽니다.
- Xcode에서 프로젝트 파일을 열고 빠진 파일이나 경로 오류가 있는지 살펴봅니다.
- 이미지와 데이터 등 수업 자료가 화면이나 실행 결과에 정상적으로 나타나는지 확인합니다.
- 과제 요구에 맞춰 빌드하거나 실행하고, 실패하면 코드·리소스·개발 환경 가운데 무엇이 원인인지 나눠 점검합니다.
이 과정에서 도구 환경도 확인하세요. Xcode 27을 사용할 수 있는지와 필요한 시스템 조건은 Xcode 시스템 요구 사항 및 Xcode 27 출시 안내에서 다시 확인할 수 있습니다. 저장소에서 파일이 잘 복구되어도 현재 환경이 수업의 도구 요구를 충족하지 못하면 빌드 검증은 끝난 것이 아닙니다.
원격 Mac 한 대에만 두면 접속 환경이나 보관 규칙을 확인해야 하고, 개인 PC에만 복사하면 Xcode가 필요한 과제에서 작업 환경을 따로 마련해야 합니다. 두 방식 모두 파일 누락과 환경 차이를 직접 관리해야 합니다. 맥이 필요한 과제를 계속해야 한다면 VPSNIX의 이용 안내에서 사용 전 확인 사항을 살펴보고, 원격 Mac 환경이 필요한 기간과 조건을 따져 요금 안내를 비교해 보세요. 어떤 환경을 선택하든 저장소 푸시와 별도 파일 보관, 복구 후 빌드 테스트는 직접 완료해야 합니다.