Dari
iOS

연결과 문제 해결

iOS 앱이 데스크톱 앱과 연결되는 방식, Staging 빌드, 자주 겪는 문제

연결

  1. Simulator나, USB로 연결한 iPhone·iPad에서 앱을 실행합니다.
  2. 같은 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에서 하는 셈입니다.

  1. 데스크톱 앱이 usbmuxd(/var/run/usbmuxd)에 연결된 기기 목록을 묻습니다. 모든 iOS 기기가 포트 62078에서 실행하는 lockdownd 서비스에서 기기 이름도 읽어 옵니다.
  2. 38670...38677의 각 포트마다 usbmuxd에 기기의 그 포트로 연결해 달라고 요청합니다. 아무것도 listen하지 않는 포트는 usbmuxd가 바로 거절합니다.
  3. 연결된 포트에 Dari handshake를 보냅니다. Dari 앱이면 bundle ID로 답하고, 목록에 나타납니다.
  4. 사용자가 고른 연결은 같은 터널을 계속 씁니다. 케이블을 뽑으면 끊기고, 기기를 다시 꽂으면 데스크톱 앱이 다시 연결합니다.

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를 시작합니다.

  1. Staging 구성의 Active Compilation Conditions(SWIFT_ACTIVE_COMPILATION_CONDITIONS)에 DARI를 추가합니다.
  2. #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:)로 다른 범위를 넘기세요. 단, 데스크톱 앱은 기본 범위만 확인합니다.

On this page