xtool로 Windows에서 iOS 앱 빌드하고 시험하기

xtool은 Windows의 WSL에서 Swift로 만든 iOS 앱을 빌드하고 서명해 실제 iPhone에 설치하는 오픈소스 도구입니다. WSL은 Windows 안에서 Linux를 실행하는 기능입니다. xtool은 터미널 명령으로 실행하며 SwiftPM 프로젝트를 다룹니다. 공식 저장소

앱을 기기에 넣으려면 Apple의 iOS SDK, 개발자 계정, 연결한 iPhone을 준비합니다. xtool은 Linux와 macOS에서도 동작합니다. macOS에서는 iOS SDK와 도구 체인을 위해 Xcode가 필요합니다.

Windows에서 xtool로 할 수 있는 일

Windows의 WSL이나 Linux에서 Swift 코드를 작성한 뒤에는 그 코드를 iPhone에서 실행할 앱으로 묶고 실제 기기에 넣는 과정이 필요합니다. xtool은 SwiftPM 프로젝트의 빌드·서명·설치를 터미널 명령으로 이어 주는 도구입니다. Windows를 주로 쓰는 개발자가 간단한 앱을 자신의 iPhone에서 시험하려는 상황에 맞습니다.

Windows에서도 Apple의 iOS SDK가 필요한 이유

xtool을 Windows·Linux에서 실행해도 앱이 iPhone의 기능을 사용하려면 Apple에서 제공하는 개발 도구가 필요합니다. 앱을 빌드할 때 Apple의 iOS SDK가 필요합니다. Linux·WSL에서는 공식 설치 문서에 따라 Apple에서 받은 Xcode XIP 파일로 SDK를 구성합니다. macOS에서는 Xcode 설치가 필요합니다. xtool은 SwiftPM(Swift Package Manager) 프로젝트를 다룹니다. SwiftPM은 Swift 코드와 필요한 패키지를 묶어 빌드하는 도구입니다.

예를 들어 Linux 노트북에서 작은 Swift 앱을 시험하려는 개발자라면, 코드를 작성한 뒤 xtool로 앱 형태로 빌드하고 자신의 iPhone에 설치해 볼 수 있습니다. 이것은 공식 문서가 안내하는 작업 흐름을 바탕으로 한 이해용 상황입니다. 모든 기존 Xcode 프로젝트가 수정 없이 옮겨진다고 볼 수는 없습니다.

저장소는 xtool-org 조직 계정에서 공개됩니다. 저장소의 MIT 라이선스 파일에는 2024년 Kabir Oberai가 권리자로 적혀 있습니다. 저장소 소유 계정과 라이선스에 적힌 권리자를 구분해 보는 편이 정확합니다.

코드에서 iPhone 앱까지, 어떤 순서로 움직이나요?

핵심은 SwiftPM 프로젝트 → iOS용 SDK를 이용한 빌드 → Apple 개발자 서비스의 서명 준비 → 연결한 기기에 설치입니다. SDK는 앱이 iOS 기능을 사용하도록 빌드할 때 필요한 개발용 도구 모음입니다. 서명은 앱과 개발자 계정을 연결해 기기가 앱을 받아들이도록 하는 절차입니다.

공식 첫 앱 튜토리얼에서는 xtool new로 프로젝트를 만들고 xtool dev로 빌드·설치하는 흐름을 보여 줍니다. 첫 실행에서는 기기 신뢰 확인이나 개발자 모드 설정이 필요할 수 있습니다. xtool은 Apple 개발자 서비스와 통신해 기기 등록, 인증서·앱 ID·프로비저닝 프로필 준비, 앱 서명과 설치를 진행한다고 문서에 설명합니다.

누구에게 유용하고, 어디까지 기대해야 할까요?

• Linux·WSL을 주 개발 환경으로 쓰는 Swift 개발자: Mac으로 작업 환경을 옮기지 않고 SwiftPM 기반 iOS 앱을 시험할 경로가 생깁니다. 다만 SDK 준비와 실제 iPhone 연결이 필요합니다.
• 반복 작업을 명령으로 묶고 싶은 개발자: 프로젝트 생성, 빌드·실행, 기기 목록·설치 같은 작업을 CLI에서 다룰 수 있습니다. 자동화 적합성은 사용 환경에서 별도 검증해야 합니다.
• macOS 개발자: Xcode의 빌드 시스템 대신 SwiftPM 중심의 선언적 작업 방식을 시도할 수 있습니다. 공식 설치 문서에 따르면 iOS SDK와 Swift 도구 체인을 위해 Xcode 자체는 설치해야 합니다.

일반 iPhone 사용자라면 xtool을 설치할 이유가 거의 없습니다. 앱 개발 도구이기 때문입니다. 또한 공식 소개의 “Xcode replacement”는 프로젝트의 지향점을 표현한 문구입니다. 시각적 편집기, 시뮬레이터, 모든 Xcode 프로젝트 기능까지 동일하게 제공한다는 근거로 해석해서는 안 됩니다.

공식 다운로드와 설치 방법

공식 배포 파일은 xtool-org GitHub Releases에서 확인할 수 있습니다. 2026년 11월 9일 확인한 최신 릴리스 표시는 v1.24.0이며 버전과 파일명은 이후 바뀔 수 있습니다. 아래 버튼은 파일을 곧바로 실행하거나 설치하지 않고 공식 최신 릴리스 페이지를 엽니다.

운영체제별 준비 사항을 먼저 읽고 저장소 소유자가 제공한 배포 파일을 선택하세요.

Linux 또는 Windows의 WSL

1. Windows라면 WSL을 설치하고 iPhone을 USB로 사용할 계획이면 공식 문서에 나온 USB 연결 설정을 확인합니다. Linux·WSL에서는 문서가 요구하는 Swift 6.4 도구 체인과 기기 통신용 usbmuxd를 준비합니다.
2. Apple 개발자 다운로드에서 문서가 지정한 Xcode 27.1의 XIP 파일을 받습니다(2026년 11월 8일 확인 기준). Apple ID 로그인과 라이선스 동의가 필요합니다. 이 파일은 xtool의 iOS Swift SDK 구성에 사용됩니다.
3. 공식 Linux·Windows 설치 문서에 나온 자신의 CPU 아키텍처용 AppImage를 내려받아 실행 권한을 주고 경로에 배치합니다. 배포 파일명과 설치 명령은 문서의 최신 내용을 그대로 확인하세요.

Windows 주의: PowerShell에 Linux용 설치 명령을 그대로 붙여 넣는 절차가 아닙니다. WSL 안의 Linux 터미널에서 실행합니다. USB 기기를 연결할 때는 WSL과 Windows 양쪽의 설정이 영향을 줍니다.

macOS

1. Xcode를 설치하고 한 번 실행해 초기 설정을 마칩니다.
2. Homebrew를 사용한다면 아래 명령으로 설치합니다. 앱으로 설치하려면 공식 릴리스의 xtool.app 절차를 따릅니다. 공식 macOS 설치 문서

macOS 터미널에서 iOS SDK가 연결됐는지 확인하려면 아래 명령을 실행합니다.

xcrun -sdk iphoneos -show-sdk-path

Homebrew가 준비된 Mac에서는 같은 터미널에서 아래 설치 명령을 실행합니다.

brew install xtool-org/tap/xtool

설치 확인과 계정 설정

Linux·WSL 터미널 또는 macOS 터미널에서 첫 줄을 실행합니다. 도움말이 표시되면 둘째 줄로 초기 설정을 시작합니다. Linux·WSL에서는 안내에 따라 준비한 Xcode XIP 파일 경로를 입력합니다.

xtool --help
xtool setup

두 환경 모두 계정 인증에서 공식 문서는 유료 Apple Developer Program 회원에게 공개 App Store Connect API를 사용하는 API 키 방식을 권장합니다. 일반 Apple ID로 선택할 수 있는 비밀번호 방식은 Apple의 비공개 API를 사용한다고 문서가 명시합니다. 계정·2단계 인증 정보를 다루는 만큼 해당 방식을 이해하고 선택하세요. MIT 라이선스는 xtool 소스 코드에 적용됩니다. Apple 계정·SDK·배포에는 별도 조건이 적용됩니다.

설치 후 첫 앱을 시험하려면

작업 폴더를 터미널에서 연 뒤 다음 명령으로 SwiftPM 프로젝트를 만듭니다. 프로젝트 설정 파일 xtool.yml에 적힌 Bundle ID는 앱을 구분하는 고유 이름입니다. 공식 첫 앱 튜토리얼

xtool new

생성한 프로젝트 폴더로 이동하고 iPhone을 연결합니다. 다음 명령으로 앱을 빌드하고 기기에 설치합니다. 처음 연결할 때 iPhone에서 컴퓨터 신뢰 확인이나 개발자 모드 설정이 필요할 수 있습니다.

xtool dev

설치 절차는 공식 문서를 바탕으로 정리했습니다. 이 글에서 실제 iPhone 배포를 시험하지는 않았습니다.

xtool이 지원하는 범위와 준비 사항

• 대상 프로젝트: 공식 문서가 안내하는 중심 경로는 SwiftPM 기반 앱입니다. 기존 Xcode 프로젝트의 완전한 호환성을 전제로 삼지 마세요.
• 준비 비용과 난이도: xtool 코드에는 MIT 라이선스가 적용됩니다. 실행하려면 Xcode 파일·Swift 도구 체인·Apple 계정·실제 기기·USB 연결 설정이 필요합니다. 공식 문서가 권장하는 API 키 인증은 유료 Apple Developer Program 회원이 대상입니다.
• 계정 방식: 비밀번호 로그인은 공식 문서상 비공개 Apple API에 의존합니다. Apple 쪽 변경에 영향을 받을 수 있다는 점은 추론 가능한 운영상 위험입니다. 지속 동작은 보장할 수 없습니다.
• 배포 범위: 내 기기에서 시험하는 과정과 App Store 출시 요건은 다른 문제입니다. App Store 제출에는 Apple Developer Program 회원 자격과 별도 배포 요건이 필요합니다. xtool이 제출 전 과정을 대신할 수 있는지는 확인하지 못했습니다.

xtool은 특히 Linux·WSL에서 SwiftPM 기반 iOS 앱을 시험하려는 개발자에게 새로운 선택지를 제공합니다. 첫 단계는 릴리스 파일을 받는 것보다 자신의 환경에서 Swift·SDK·기기 연결·인증 방식이 준비 가능한지 확인하는 일입니다.

무료 Apple 계정으로 기기에서 시험할 때

Apple의 무료 개인 개발 팀(Personal Team)으로 내 iPhone에서 앱을 시험하면, Apple이 발급하는 설치용 프로비저닝 프로필이 7일 뒤 만료됩니다. 이 프로필은 어떤 앱을 어느 기기에 설치할 수 있는지 정하는 승인 정보입니다. Apple은 만료 후 시험을 계속하려면 앱을 다시 빌드해 기기에 재설치하도록 안내합니다. xtool의 자동 갱신·재설치 동작은 확인하지 못했습니다. Apple 무료 개인 개발 팀 안내

라이선스 및 상업적 이용 안내

• 개인 실습 — xtool 자체는 무료입니다. Apple 무료 계정의 개인 기기 시험에는 설치 프로필 7일 제한이 적용됩니다.
• 회사 업무와 유료 앱 개발 — 개인과 조직 모두 MIT 조건에 따라 xtool을 무료로 사용하고 수정할 수 있습니다. 도구 자체의 복사본이나 주요 부분을 배포한다면 저작권 표시와 MIT 문구를 포함해야 합니다.
• App Store에서 배포·판매 — 유료 Apple Developer Program 회원 자격과 Apple의 배포·심사 절차가 필요합니다. 앱에 넣는 이미지, 글꼴, 외부 라이브러리에도 각 자산의 조건이 적용됩니다. MIT 라이선스 · Apple 계정·배포 안내

Windows·WSL에서 Apple SDK를 쓰는 경우에는 Apple의 별도 약관이 중요합니다. xtool 문서는 Apple에서 받은 Xcode XIP로 SDK를 구성하는 기술 절차를 안내합니다. Apple의 공개 Xcode·SDK 계약 제2.2조는 Apple 소프트웨어의 설치 허용을 자신이 소유하거나 관리하는 Apple 브랜드 컴퓨터로 한정합니다. 일반 Windows PC에서 XIP를 추출해 쓰는 경로에 대한 Apple의 별도 허용은 확인하지 못했습니다. 공식 자료는 2026년 11월 8일에 확인했습니다. xtool Linux·WSL 설치 문서 · Apple Xcode·SDK 계약서 §2.2

확인 자료: 공식 저장소, Linux·Windows 설치 문서, macOS 설치 문서, 첫 앱 튜토리얼, Apple 계정별 테스트 제한, 라이선스 (2026년 11월 8일 확인).

본 게시글은 AI의 도움을 받아 작성되었으며 공식 자료를 참고하여 내용을 구성했습니다. 본문 도식과 대표 이미지는 AI·디자인 도구를 사용해 제작했습니다.