판단: 적합합니다. Windows에서 과제 코드를 커밋하고 푸시한 뒤 원격 Mac에서 변경 사항을 가져와 Xcode로 여는 방식이 안전합니다. 단, GitHub Desktop은 코드 버전을 관리할 뿐 Windows에서 Xcode를 실행하거나 파일을 자동 동기화하지 않습니다.
이 글은 Windows만 사용하며 SwiftUI나 아이오에스 개발을 시작한 학생에게 적합합니다.
이미 수업 저장소가 있거나 학교 컴퓨터와 원격 Mac 사이에서 과제를 이어야 하는 경우에도 활용할 수 있습니다.
00먼저 저장소 접근 권한과 작업 위치를 확인합니다
GitHub Desktop은 Windows와 macOS에서 사용할 수 있으며, 저장소를 복제하고 변경 사항을 커밋하거나 푸시하는 작업을 지원합니다. 따라서 두 컴퓨터가 같은 저장소를 바라보도록 설정하면 과제 변경 이력을 이어갈 수 있습니다. 다만 프로그램을 설치했다고 해서 프로젝트가 저절로 옮겨지는 것은 아닙니다. GitHub Desktop의 지원 환경과 기능 안내를 확인하고, 수업 저장소에 접근할 계정도 준비합니다.
개인 저장소의 권한은 읽기, 분류, 쓰기, 유지 관리, 관리자까지 5단계로 나뉩니다. 과제 변경 내용을 저장소에 올리려면 푸시가 가능한 쓰기 권한이 필요합니다. 권한이 없으면 담당 교사나 저장소 관리자가 초대 또는 권한 변경을 해야 합니다. 개인 저장소 권한 단계와 접근 안내를 먼저 확인하세요.
01Windows에서 과제 변경을 기록하고 원격 저장소로 보냅니다
Windows에서 GitHub Desktop을 열고 수업 저장소를 복제하거나 이미 복제한 저장소를 선택합니다. 작업하기 전에 저장소 이름과 현재 브랜치를 살펴보세요. 과제용 저장소가 맞는지 확인하면 다른 수업 파일을 잘못 수정하는 일을 줄일 수 있습니다.
코드를 수정한 다음에는 변경 목록에서 파일과 차이를 확인합니다. 커밋은 수정 내용을 작업 이력에 기록하는 단계이고, 푸시는 그 기록을 원격 저장소에 올리는 단계입니다. 커밋만 하고 푸시하지 않으면 원격 Mac에서 아직 변경 내용을 가져올 수 없습니다. GitHub Desktop에서 변경 내용을 푸시하는 순서를 따라 상태를 확인하세요.
변경 목록에 과제와 관계없는 파일이 섞여 있다면 커밋을 멈추세요. 파일을 하나씩 살펴본 뒤 필요한 변경만 기록해야 수업 자료나 개인 설정이 함께 올라가는 일을 막을 수 있습니다.
02원격 Mac에서 최신 코드를 가져와 Xcode로 엽니다
원격 Mac에서 같은 저장소를 처음 사용할 때는 저장소를 복제합니다. 이미 저장소가 있다면 Windows에서 푸시한 변경 사항을 가져온 다음 프로젝트 파일을 엽니다. Xcode는 Git 저장소를 사용해 프로젝트의 변경 이력을 관리할 수 있지만, 저장소와 Xcode 프로젝트는 같은 것이 아닙니다. 저장소에는 파일과 변경 기록이 있고, Xcode는 그 안의 프로젝트를 열어 코드를 편집하고 빌드하는 도구입니다. Apple의 Xcode 프로젝트 소스 관리 설정 안내와 Xcode 소스 관리 기능 설명을 참고하세요.
이 단계의 완료 기준은 프로젝트 파일이 Xcode에서 열리고, 과제에서 수정해야 할 코드 파일을 찾을 수 있는 것입니다. 열리지 않는다면 저장소에 프로젝트 파일이 들어 있는지, 과제 지침에서 요구한 파일이 빠지지 않았는지 먼저 확인합니다. 저장소가 갱신되지 않은 것 같으면 GitHub Desktop의 브랜치 동기화 안내에 따라 원격 변경 사항을 확인하세요.
| 작업 단계 | Windows의 GitHub Desktop | 원격 Mac의 GitHub Desktop과 Xcode |
|---|---|---|
| 처음 시작 | 수업 저장소를 복제하거나 기존 저장소를 엽니다 | 같은 저장소를 복제합니다 |
| 코드 전달 | 수정 내용을 검토하고 커밋한 뒤 푸시합니다 | 원격 저장소에서 변경 사항을 가져옵니다 |
| 과제 확인 | 원격 Mac에서 올라온 변경 사항을 가져옵니다 | Xcode로 프로젝트를 열어 파일과 작업 내용을 확인합니다 |
03수정한 과제를 다시 Windows에서 이어갑니다
원격 Mac에서 코드를 수정했다면 먼저 파일을 저장하고 변경 목록을 확인합니다. 필요한 수정만 커밋하고 푸시한 뒤 Windows로 돌아가세요. Windows의 GitHub Desktop에서 원격 저장소의 변경 사항을 가져오면 Mac에서 기록한 코드와 변경 이력을 확인할 수 있습니다.
두 컴퓨터에서 같은 부분을 각각 고쳤다면 병합 충돌이 생길 수 있습니다. 이때는 한쪽 변경을 무조건 덮어쓰지 말고, 충돌 위치를 열어 두 작업의 의도를 비교해야 합니다. Xcode에서 충돌을 해결할 때는 Apple의 저장소 변경 사항 병합 안내를 참고할 수 있습니다. 해결한 뒤에는 프로젝트가 다시 열리는지 확인하고, 정리한 결과를 커밋해 기록을 남깁니다.
04제출할 파일과 제외할 파일을 구분합니다
과제에 필요한 소스 코드와 프로젝트 설정 파일은 수업 안내를 기준으로 판단합니다. 빌드 결과물이나 개인 환경 설정처럼 다시 만들 수 있는 파일은 저장소에서 제외하는 경우가 있지만, 프로젝트 의존성이나 과제 지침에 따라 달라질 수 있습니다. GitHub의 파일 무시 설정 안내와 Swift 프로젝트 무시 규칙 예시를 대조하되, 예시를 그대로 적용하기보다 실제 과제에 필요한 파일인지 확인하세요.
비밀번호, 인증 토큰, 개인 키는 저장소에 넣지 않습니다. 이미 올렸다면 파일을 삭제하는 것만으로 노출이 해결되지 않을 수 있으므로, GitHub의 저장소에서 민감한 정보 제거 안내에 따라 대응해야 합니다.
- [ ] 수업 저장소가 맞고, 계정에 푸시 권한이 있습니다.
- [ ] Windows에서 변경 목록을 검토하고 과제와 무관한 파일을 제외했습니다.
- [ ] 커밋 후 푸시까지 완료해 원격 저장소에 변경 내용을 올렸습니다.
- [ ] 원격 Mac에서 최신 변경 사항을 가져온 뒤 Xcode로 프로젝트를 열었습니다.
- [ ] Mac에서 수정한 내용도 커밋하고 푸시한 뒤 Windows에서 가져왔습니다.
- [ ] 비밀번호와 토큰, 개인 키가 저장소에 들어 있지 않은지 확인했습니다.
05자주 막히는 지점을 과제 흐름에 맞춰 확인합니다
GitHub Desktop에서 푸시했는데 Mac에 코드가 보이지 않습니다
원격 Mac에서 같은 저장소를 열었는지 먼저 확인합니다. 이어서 해당 저장소의 최신 변경 사항을 가져왔는지 살펴보세요. Windows에서 커밋만 하고 푸시하지 않았다면 원격 저장소에 코드가 없으므로 Mac에서도 받을 수 없습니다. GitHub Desktop은 폴더를 자동 복사하는 동기화 도구가 아닙니다.
Windows에서 Xcode를 바로 실행할 수 있나요?
GitHub Desktop을 설치해도 Windows에서 Xcode를 실행할 수 있게 되지는 않습니다. Windows에서는 코드와 변경 이력을 관리하고, Xcode가 필요한 작업은 접근 권한이 있는 macOS 환경에서 진행해야 합니다. 수업에서 빌드나 시뮬레이터 확인을 요구한다면 그 단계가 가능한 원격 Mac 환경인지 미리 점검하세요.
충돌 표시가 생기면 한쪽 파일을 지워도 되나요?
충돌이 난 부분을 확인하지 않고 파일을 삭제하거나 덮어쓰면 다른 컴퓨터에서 작성한 수정이 사라질 수 있습니다. 두 변경 내용을 비교해 필요한 코드를 남기고, 해결 결과를 프로젝트에서 확인한 다음 커밋하세요. 충돌이 난 이유가 불분명하면 마지막으로 정상 작동했던 커밋을 확인하고 수업 담당자에게 기준을 문의하는 편이 안전합니다.
06필요할 때만 원격 Mac을 학습 환경에 더합니다
Windows는 일상적인 코드 작성에는 쓸 수 있지만 Xcode를 직접 실행할 수 없고, 학교 컴퓨터에서는 필요한 앱 설치가 제한될 수 있습니다. 파일을 직접 복사하는 방식은 어떤 버전이 최신인지 헷갈리게 만들며, GitHub도 커밋과 푸시를 생략한 변경을 자동으로 옮겨주지 않습니다. 따라서 아이오에스 과제에서 Xcode로 열기나 빌드가 필요하다면 코드 이력은 GitHub Desktop으로 관리하고, 실행과 확인은 원격 Mac에서 맡기는 구성이 현실적입니다.
먼저 원격 Mac 학습 환경을 확인할 수 있는 안내를 살펴보고, 수업에서 실제 macOS 작업이 필요한 경우에만 NUKCLOUD의 원격 Mac 이용 정보를 확인하세요. 매일 장시간 안정적으로 무거운 작업을 하거나 물리 기기를 직접 연결해야 한다면 개인 Mac이 더 맞을 수 있습니다. 반대로 수업 프로젝트를 확인하는 기간에만 Xcode가 필요하다면 필요한 기간에 맞춰 원격 Mac을 이용하는 편이 초기 장비 구매 부담을 피하는 선택지가 됩니다.