연결과 문제 해결
iOS 앱이 데스크톱 앱과 연결되는 방식, Staging 빌드, 자주 겪는 문제
연결
- Simulator나, USB로 연결한 iPhone·iPad에서 앱을 실행합니다.
- 같은 Mac에서 Dari 데스크톱 앱을 엽니다. Simulator 앱은 iOS Simulator 기기 아래에, USB 기기는 그 기기 이름 아래에 나타납니다. 그곳의 Dari 앱이 하나뿐이면 자동으로 연결합니다.
앱마다 127.0.0.1의 38670...38677 중 비어 있는 첫 포트에서 listen하므로, 기기 하나에서 Dari 앱을 최대 8개까지 동시에 실행할 수 있습니다. 앱을 다시 실행해 다른 포트에 자리 잡아도 데스크톱 앱이 다시 찾아 연결합니다.
연결 동작 원리
앱은 네트워크에 포트를 열지 않습니다. 자기 자신의 loopback 주소인 127.0.0.1에서만 listen합니다. 데스크톱 앱은 두 가지 방법 중 하나로 그 주소에 닿습니다.
Simulator. Simulator 앱은 Mac 위의 프로세스로 실행되므로 Mac과 loopback을 같이 씁니다. 데스크톱 앱이 127.0.0.1:38670부터 차례로 바로 접속합니다.
USB 기기. iPhone의 loopback은 iPhone 안에 있어서 Mac이 네트워크로는 닿을 수 없습니다. 대신 macOS에는 Finder와 Xcode가 케이블로 기기와 통신할 때 쓰는 usbmuxd 데몬이 있습니다. Mac의 프로그램이 usbmuxd에 "기기의 이 포트로 연결해 달라"고 요청하면, usbmuxd가 USB 연결을 그 포트로 가는 바이트 통로로 만들어 줍니다. 이것을 포트 터널링이라고 합니다. Android의 adb forward가 하는 일을 iOS에서 하는 셈입니다.
- 데스크톱 앱이 usbmuxd(
/var/run/usbmuxd)에 연결된 기기 목록을 묻습니다. 모든 iOS 기기가 포트 62078에서 실행하는 lockdownd 서비스에서 기기 이름도 읽어 옵니다. 38670...38677의 각 포트마다 usbmuxd에 기기의 그 포트로 연결해 달라고 요청합니다. 아무것도 listen하지 않는 포트는 usbmuxd가 바로 거절합니다.- 연결된 포트에 Dari handshake를 보냅니다. Dari 앱이면 bundle ID로 답하고, 목록에 나타납니다.
- 사용자가 고른 연결은 같은 터널을 계속 씁니다. 케이블을 뽑으면 끊기고, 기기를 다시 꽂으면 데스크톱 앱이 다시 연결합니다.
Wi-Fi, IP 주소, 추가 도구는 쓰지 않습니다. 같은 Wi-Fi에 있어도 케이블로 연결하지 않은 기기는 나타나지 않습니다.
Staging 빌드
Android는 manifest 메타데이터로 opt-in해서, minify가 켜지고 debuggable이 아닌 빌드(staging)도 검사합니다. iOS에는 R8 같은 코드 이름 변경(난독화)이 없습니다. Release 빌드는 최적화(-O, whole-module)와 dead code stripping을 거치지만 Dari에는 영향이 없습니다. Dari는 리플렉션이나 런타임 클래스 조회를 쓰지 않기 때문입니다.
Release와 비슷한 빌드를 검사하려면 빌드 구성(예: Staging)을 추가하고, 그 구성 전용 컴파일 조건으로 Dari를 시작합니다.
- Staging 구성의 Active Compilation Conditions(
SWIFT_ACTIVE_COMPILATION_CONDITIONS)에DARI를 추가합니다. #if DEBUG || DARI로 Dari를 시작합니다.
샘플 앱에 Debug, Staging, Release 구성이 이렇게 설정되어 있습니다.
Swift Package Manager는 패키지를 일부 구성에만 링크할 수 없습니다. 그래서 앱이 start()를 호출하지 않아도 Dari 코드(arm64 기준 약 170KB)는 Release 바이너리에 남습니다. 이 코드는 동작하지 않습니다. 소켓을 열지 않고 아무것도 기록하지 않습니다. 용량이 중요하다면 별도의 디버그 타깃을 두는 식으로 App Store 타깃에서 Dari를 아예 빼세요.
문제 해결
- 앱이 목록에 없습니다. 앱이 포그라운드에 있어야 합니다. 일시 정지된 Simulator 앱은 응답하지 않습니다.
start()가 실행됐는지, 포트가 열려 있는지 확인합니다:lsof -nP -iTCP:38670-38677 -sTCP:LISTEN - Simulator 두 대에서 같은 앱을 실행했습니다. 데스크톱 앱은 먼저 찾은 쪽에 연결합니다. 하나를 종료하세요.
- iPhone이 목록에 없습니다. 잠금을 풀고 이 컴퓨터를 신뢰를 수락한 뒤 Finder에 기기가 보이는지 확인합니다. 기기는 케이블로 연결했을 때만 나타납니다.
- iPhone은 보이는데 앱이 없습니다. 앱을 포그라운드로 가져옵니다. iOS는 백그라운드 앱을 일시 정지시키고, 일시 정지된 앱은 응답하지 못합니다.
start()가noFreePort를 던집니다. Dari 앱 8개가 이미 포트를 쓰고 있습니다. 일부를 종료하거나DariConfiguration(ports:)로 다른 범위를 넘기세요. 단, 데스크톱 앱은 기본 범위만 확인합니다.