puncture/goapp/ios/INSTALL_IPHONE.md

2.1 KiB

EmergencyPuncture iPhone Install Guide

This project already builds successfully for iOS.
Current local artifacts:

  • Unsigned archive: goapp/ios/dist/EmergencyPuncture.xcarchive
  • Unsigned IPA (not installable as-is): goapp/ios/dist/EmergencyPuncture-unsigned-proper.ipa

To install on a real iPhone, you must sign with an Apple Team.

  1. Connect your iPhone to the Mac with USB.
  2. On iPhone, tap Trust This Computer if prompted.
  3. Open project:
    • goapp/ios/EmergencyPuncture/EmergencyPuncture.xcodeproj
  4. In Xcode:
    • Select target EmergencyPuncture
    • Open Signing & Capabilities
    • Enable Automatically manage signing
    • Select your Team (Apple ID Personal Team or paid Developer Team)
  5. In the Xcode device selector, choose your connected iPhone.
  6. Press Run (Cmd+R).
  7. If iOS blocks launch the first time:
    • iPhone Settings > General > VPN & Device Management
    • Trust your developer certificate
    • Re-run from Xcode.

Option 2: Build signed IPA from terminal

  1. Ensure step 4 above is complete at least once in Xcode (Team selected).
  2. Get your Team ID (10 chars) from:
    • Apple Developer account
    • or Xcode Signing & Capabilities details.
  3. Run:
cd /Users/oho/GitClone/CodexProjects/puncture/goapp/ios
TEAM_ID=YOURTEAMID ./build_signed_ipa.sh
  1. Output:
    • Archive: goapp/ios/dist-signed/EmergencyPuncture-YOURTEAMID.xcarchive
    • IPA: goapp/ios/dist-signed/export-debugging/EmergencyPuncture.ipa

Install signed IPA to iPhone

Use one of these:

  1. Apple Configurator 2 (Mac App Store):
    • Connect iPhone
    • Drag the signed .ipa onto the device
  2. Xcode Organizer:
    • Window > Organizer
    • Select archive
    • Distribute App for development/internal flow

Known failure and meaning

  • No Team Found in Archive: The app was archived without a Team (DEVELOPMENT_TEAM empty), so export cannot sign.
    Fix by selecting Team in Xcode, then rebuild/export.
  • Signing for "EmergencyPuncture" requires a development team: No Team is configured yet for this target.
    Fix in Xcode Signing & Capabilities by selecting your Team.