이번 주에는 인터넷 연결을 끊고 작품을 시작부터 끝까지 실행해 보세요. 로그인이나 온라인 자료, 제출 파일에 포함되지 않은 리소스가 있어야만 핵심 경험을 할 수 있다면, 오프라인 검수는 아직 끝나지 않은 것입니다. 2027년 공식 참가 약관을 확인한 뒤 의존성을 고치고 제출 파일을 다시 점검해야 합니다.
이 글은 Xcode 27로 작품을 만드는 학생이 네트워크와 로컬 리소스를 확인할 때 적합합니다.
Swift Playground 4.7로 App Playground를 만드는 학생은 주요 경험이 온라인 콘텐츠에 기대지 않는지 살펴볼 수 있습니다.
주로 윈도우를 사용한다면, 제출 규칙을 먼저 확인하고 작품을 빌드하고 실행할 macOS 환경도 점검하세요.
마지막 업데이트: 2026년 11월 12일. 날짜와 도구 조건은 Apple의 Swift Student Challenge 공식 약관 및 공식 준비 안내를 기준으로 확인했습니다.
오프라인에서 핵심 경험이 시작되는지 먼저 확인합니다
2027년 대회 공식 약관은 작품이 네트워크에 의존하지 않아야 하며, 제출 작품은 오프라인으로 평가되고 필요한 리소스는 제출 ZIP 파일에 포함되어야 한다고 안내합니다. 작품 형식과 도구 조건에는 Xcode 27 또는 Swift Playground 4.7도 명시되어 있습니다. 세부 자격과 제출 조건은 바뀔 수 있으므로 현행 공식 약관을 기준으로 판단하세요.
인터넷을 끊으면 작품을 쓸 수 없을 때는 어떻게 해야 하나요?
먼저 어떤 단계에서 멈추는지 기록하세요. 시작 화면, 첫 사용 안내, 주요 상호작용, 결과 화면을 차례로 확인하고, 막힌 단계가 로그인인지 자료 로딩인지 구분합니다. 핵심 기능이 진행되지 않는다면 화면에 안내 문구만 추가하는 대신 기능을 오프라인에서도 쓸 수 있게 조정해야 합니다.
코드에 네트워크 요청이 있는지만 검색해서 통과 여부를 판단하면 안 됩니다. 앱에서 요청을 실행하지 않아도 외부 이미지나 재생 목록을 화면에 표시하려 할 수 있습니다. 반대로 네트워크 관련 코드가 있더라도 작품의 핵심 경험에 필요하지 않은 선택 기능일 수 있습니다. 실제 기기나 실행 환경에서 연결을 끊고 작품을 사용해 보세요.
계정과 온라인 기능을 각각 분리해 점검합니다
작품에 네트워크 요청이 들어가면 무조건 사용할 수 없나요?
공식 약관의 기준은 작품이 오프라인에서 실행되는지입니다. 따라서 API 요청이 있는지 자체만으로 결론을 내리지 말고, 요청이 실패했을 때 핵심 경험이 계속되는지 확인하세요. 앱이 외부 콘텐츠 없이도 작동하도록 설계할 수 없다면 그 기능이 작품의 핵심인지 다시 검토해야 합니다. 네트워크 요청이 쓰이는 경우에는 Apple의 URL 로딩 시스템 문서에서 요청이 발생하는 위치를 확인할 수 있습니다.
로그인, 계정 생성, 온라인 권한 확인도 별도로 시험합니다. 앱을 새로 열었을 때 가입 화면을 지나야만 작품을 볼 수 있는지, 주요 동작 중 외부 서비스의 승인을 기다리는지 확인하세요. 어떤 인증이 꼭 필요한지 확실하지 않다면 불필요한 의존성을 제거하고 공식 약관을 확인하는 편이 안전합니다. 이 안내만으로 참가 자격이나 심사 결과를 판단할 수는 없습니다.
로컬 환경에서 네트워크 관련 코드를 찾을 때는 아래처럼 문자열을 검색할 수 있습니다.
grep -RInE 'URLSession|https?://' .
예시 출력은 다음과 같습니다.
Sources/ContentLoader.swift:18: URLSession.shared.dataTask(with: url)
검색 결과는 출발점일 뿐입니다. 주석이나 예제 코드도 잡힐 수 있고, 결과가 없더라도 앱에서 사용하는 외부 자료가 없다는 뜻은 아닙니다. 검색된 호출이 실제로 실행되는지 확인한 다음, 연결을 끊고 다시 시험하세요.
리소스가 앱과 제출 파일에 들어 있는지 살펴봅니다
Xcode에서 필요한 그림이 제출 파일에 포함됐는지 어떻게 확인하나요?
먼저 그림과 소리 같은 파일이 프로젝트에 보이는지 확인하고, 해당 파일이 앱 대상의 리소스로 처리되는지도 점검하세요. Xcode의 자산 관리 안내와 번들에 콘텐츠를 배치하는 문서는 프로젝트의 자료를 앱에 포함하는 방법을 설명합니다. 대상의 빌드 단계에 리소스가 포함되는지는 빌드 단계 설정 안내에서 확인할 수 있습니다.
온라인 주소를 프로젝트에 적어 두었다고 로컬 파일이 되는 것은 아닙니다. 앱에서 쓰는 사진, 소리, 영상, 설명 자료를 하나씩 확인하고, 필요한 자료는 사용할 권리와 출처를 확인한 뒤 프로젝트에 포함하세요. 제출 ZIP을 만든 다음에는 그 파일을 다시 열어 필요한 항목이 들어 있는지 확인합니다. 파일 형식과 포장 방식은 2027년 약관의 현재 요구사항에 맞춰야 합니다.
제출 전에 직접 실행하며 항목별로 확인합니다
깨끗한 상태에서 다시 확인하는 과정은 프로젝트 안에서는 발견하지 못한 경로 오류를 찾는 데 도움이 됩니다. 네트워크를 끊은 환경에서 앱을 새로 열고, 아래 항목을 차례로 실행하세요.
- [ ] 인터넷 연결을 끊은 뒤 작품을 실행하고 시작 화면을 확인합니다.
- [ ] 계정 생성, 로그인 또는 온라인 승인이 필요한 단계가 있는지 시험합니다.
- [ ] 첫 사용 안내를 마친 뒤 핵심 상호작용을 진행합니다.
- [ ] 그림, 소리, 영상, 설명 자료가 비어 있거나 불러오기 오류를 내지 않는지 확인합니다.
- [ ] 결과 화면까지 도달하고, 작품을 나갔다가 다시 실행해도 진행할 수 있는지 살펴봅니다.
- [ ] 제출 ZIP을 열어 필요한 리소스와 작품 파일이 실제로 포함되어 있는지 확인합니다.
오프라인에서 선택 기능만 사용할 수 없는 경우와 핵심 기능 자체를 쓸 수 없는 경우를 구별해야 합니다. 선택 기능은 연결이 없을 때 대체 화면을 보여 주도록 만들 수 있지만, 작품의 핵심 가치를 보여 주는 데 필요한 기능이 멈춘다면 설계를 먼저 고쳐야 합니다.
오프라인 실행에 성공해도 모든 제출 조건을 충족했다는 뜻은 아닙니다. 참가 자격, 작품 형식, 제출 파일과 도구 조건은 공식 준비 안내와 현행 약관에서 별도로 확인하세요.
마지막 제출 점검은 의존성과 파일을 나눠 봅니다
아래 표는 발견한 문제에 따라 다음 행동을 결정하기 위한 기준입니다. 특정 기능이 핵심인지 판단하기 어렵다면 작품에서 그 기능을 제거했을 때 주요 경험이 유지되는지 실제로 시험하세요.
| 점검 대상 | 오프라인에서 확인할 증상 | 다음에 할 일 |
|---|---|---|
| 네트워크 요청과 계정 | 접속이나 로그인이 되지 않으면 진행이 멈춥니다. | 필수 여부를 다시 판단하고, 불필요하면 의존성을 제거합니다. |
| 외부 사진·소리·데이터 | 빈 화면이나 로딩 표시만 남습니다. | 필요한 자료의 사용 권리를 확인하고 앱에 포함합니다. |
| 핵심 흐름 | 주요 동작이나 결과 화면에 도달하지 못합니다. | 온라인 기능을 대체하거나 핵심 흐름을 다시 설계합니다. |
| 제출 ZIP | 프로젝트에는 자료가 있지만 제출 파일에서는 찾을 수 없습니다. | 제출 파일을 다시 만들고 실제 포함 여부를 확인합니다. |
| 검수 환경 | 확인할 수 있는 내용 | 놓치기 쉬운 점 |
|---|---|---|
| 개발 중인 프로젝트 | 파일 위치, 앱 대상, 빌드 단계의 리소스를 확인합니다. | 프로젝트에 보여도 앱에 포함됐다고 단정하지 않습니다. |
| 연결이 끊긴 상태 | 시작부터 결과까지 기능이 작동하는지 시험합니다. | 코드 검색만으로 실제 동작을 대신하지 않습니다. |
| 제출 ZIP | 작품에 필요한 파일이 포함됐는지 살펴봅니다. | ZIP 안에 들어 있다는 사실만으로 참가 조건 전체가 충족되지는 않습니다. |
아직 작품을 빌드하거나 실행해 볼 macOS 환경이 없다면, 현재 환경에서 확인할 수 있는 범위와 실제로 실행해야 하는 항목을 구분하세요. 윈도우만으로는 Xcode 프로젝트를 같은 방식으로 빌드하고 실행하기 어려우므로, 무리하게 제출 가능성을 추측하기보다 필요한 개발 환경 조건부터 확인하는 편이 낫습니다. NodeMini의 맥 미니 환경 안내에서 원격 환경을 살펴보고, 서울 환경 안내도 비교할 수 있습니다.
이번 점검만을 위해 맥이 필요한 학생이라면 기기를 바로 구매하기 전에 필요한 기간과 작업 범위를 따져보세요. NodeMini의 원격 맥 대여는 구매 비용을 먼저 부담하지 않고 macOS에서 빌드와 오프라인 실행을 확인하려는 경우에 고려할 수 있습니다. 다만 장기간 계속 사용하거나 물리 기기 연결이 필요한 작업이라면 대여보다 직접 보유한 맥이 더 알맞을 수 있습니다. 어느 쪽이든 작품의 제출 가능 여부를 보장하는 것은 아니므로, 최종 판단은 공식 규칙과 직접 검수한 결과를 기준으로 하세요.