• 繁體中文(香港)
  • 未簽名 IPA 及本機真機測試

    範圍及重要限制

    本機安裝只供開發及短期驗證,並非正式分發。未簽名 IPA 不能直接安裝到 iPhone,必須使用授權該裝置及所需 entitlement 的證書及簽名描述檔簽名。

    免費 Personal Team 有嚴格限制:

    • 最多 10 個 App ID,每個 7 日後到期
    • 最多 3 部裝置,每部 7 日後到期
    • 每部裝置最多 3 個 Personal Team App
    • 簽名描述檔 7 日後到期,之後須重新構建/簽名及安裝
    • 不支援 App Store Connect、TestFlight、Ad Hoc 或 App Store 分發
    • 部分受管 App 服務及 entitlement 不可用

    持續團隊測試請使用 TestFlight;無 Beta 審核的已知裝置測試請使用 Ad Hoc

    首選路線:Xcode Personal Team

    如可匯出或開啟 iOS 項目,Apple 支援的開發流程比使用第三方工具簽署預建 IPA 更合適。

    1. 在支援的 Mac 安裝目前 Xcode。
    2. 使用 Apple Account 登入 Xcode。
    3. 在 Signing & Capabilities 選擇 Personal Team
    4. 連接 iPhone/iPad、信任 Mac,並在裝置要求時啟用 Developer Mode。
    5. 選擇真機作 run destination 並構建。
    6. 7 日後重新配置及安裝。

    如 MeDo 流程只提供未簽名 IPA,請先評估以下第三方簽名風險。

    在 MeDo 生成未簽名 IPA

    在打包面板選擇本機調試及要打包的版本。

    選擇免費本機調試路線

    核對應用名稱、Bundle ID、版本/build number 及分發方式,然後按開始打包。既有 3–8 分鐘只屬估算。

    構建配置確認步驟 1 構建配置確認步驟 2

    下載及保護 IPA

    完成後從結果頁或應用詳情的導出安裝包下載 IPA。

    下載 IPA 步驟 1 下載 IPA 步驟 2

    如檔案包含私人 endpoint、測試憑證、未公開資產或專有程式碼,請視為機密,以獲批准渠道傳送並刪除舊構建。

    使用第三方簽名工具前

    Sideloadly、AltStore Classic 及 AltServer 均為第三方產品,不是 Apple 分發服務或 MeDo 元件。它們使用 Apple Account 建立或選擇 Personal Team 簽名資產,為 IPA 重新簽名並安裝至你的裝置。兩條路線都不能繞過免費 Personal Team 限制,亦不能啟用不支援的 entitlement。選擇任一路線前:

    • 確認工具符合機構及當地安全政策。
    • 只從供應商真實網站下載並驗證安裝程式。
    • 了解工具可存取的 Apple Account 憑證、token、裝置 ID、證書及應用檔案。
    • 優先使用沒有付款資料或其他私人內容的專用開發 Apple Account。
    • 絕不可提供機構 Account Holder 憑證或正式 App Store Connect API Key。
    • 保持雙重認證,使用後檢查帳號 session。
    • 不要使用來歷不明的共用簽名證書或描述檔。

    選項 1:Sideloadly

    如要由桌面工具直接簽名及安裝 IPA,可使用 Sideloadly

    1. 從官方網站下載 Sideloadly,並安裝至 Windows 或 macOS。Windows 的官方設定要求使用 Apple 直接下載版 iTunes 及 iCloud,而非 Microsoft Store 版本。
    2. 以 USB 連接並解鎖 iPhone 或 iPad,批准信任此電腦,然後在 Sideloadly 的 iDevice 欄選擇正確裝置。
    3. 將 MeDo 生成的 IPA 拖入 Sideloadly,或從 IPA 欄選取檔案。
    4. 輸入獲批准的開發 Apple Account 電郵,然後按 Start
    5. 完成密碼及雙重認證提示。Sideloadly 會向 Apple 驗證、準備開發簽名資產、為 IPA 重新簽名,並安裝至所選裝置。
    6. 開啟應用前,先完成下方的首次啟動及續期檢查。

    使用免費 Apple Account 時,已簽名應用會在 7 日後到期。你可用同一 Apple Account 重新簽名同一 IPA。Sideloadly 可將應用加入自動重新整理,因此按 Start 前請核對此選項;如安全政策禁止背景 daemon,請將其停用。重新整理須使用 USB;或先以 USB 配對,再於 Finder 或 iTunes 啟用 Wi-Fi 同步,並讓電腦與裝置使用相同網絡。

    選項 2:AltStore Classic 及 AltServer

    請使用 AltStore Classic,而非 AltStore PAL。AltStore Classic 可安裝任意 IPA,並與 Windows 或 macOS 上的 AltServer 配合使用;AltStore PAL 不支援安裝任意 IPA。

    1. 按官方 WindowsmacOS 指南安裝 AltServer。Windows 請使用 Apple 直接下載版 iTunes 及 iCloud,而非 Microsoft Store 版本。
    2. 連接並解鎖裝置、信任電腦,然後在 iTunes 或 Finder 啟用 Wi-Fi 同步。
    3. 在 AltServer 選單選擇 Install AltStore、選取裝置,並使用獲批准的開發 Apple Account 驗證。
    4. 在裝置信任開發者身分,並按下文啟用 Developer Mode。
    5. 保持 AltServer 運行,並以 USB 連接裝置或讓兩者使用相同 Wi-Fi 網絡。將 MeDo IPA 儲存到「檔案」App,開啟 AltStore → My Apps,按 + 並選取 IPA。
    6. 完成任何 Apple Account 提示,等待 AltStore 簽名及安裝應用。
    7. 在 7 日到期前保持 AltServer 可用,並在 AltStore 使用 Refresh All。AltStore 本身會佔用免費帳號三個有效側載 App 名額中的一個。

    首次啟動及續期

    實際提示取決於簽名身分、iOS 版本及裝置管理狀態。

    1. iOS 16 或更新版本請開啟設定 → 私隱與保安 → 開發者模式,然後啟用 Developer Mode。
    2. 開啟設定 → 一般 → VPN 與裝置管理(或描述檔與裝置管理),選擇 Apple Account 對應的開發者身分,並按提示確認信任
    3. 需要時保持連線以完成 Apple 證書驗證。
    4. 開啟 App 並核對顯示的開發者身分屬於預期帳號或團隊。

    除非構建確實由合資格的自家 Apple Developer Enterprise Program 機構產生,否則不要使用「Enterprise App」信任流程。一般 Personal Team 或 Ad Hoc 構建不是企業 App。

    疑難排解

    App 已不可用

    7 日 Personal Team 描述檔可能已到期。請以 Sideloadly 重新簽名 IPA,或啟動 AltServer 並在 AltStore 使用 Refresh All。如 AltStore 本身已到期,可從 AltServer 重新安裝,而無需先刪除 AltStore。

    工具找不到裝置

    • 解鎖裝置、重新以 USB 連接,並在電腦及裝置批准信任提示。
    • Windows 請確認已安裝所選工具需要的 Apple 裝置支援元件。
    • 如使用 Wi-Fi,請啟用裝置 Wi-Fi 同步,並確保電腦與裝置使用相同網絡。
    • 如使用 AltStore,請確認 AltServer 正在運行且可連接;如網絡阻止裝置探索,請改用 USB。

    簽名失敗

    • 核對 Apple Account 及雙重認證。
    • 確認未超出裝置及 App ID 限制。
    • 檢查 Bundle ID 是否與其他有效 Personal Team App ID 衝突。
    • 移除不支援的 entitlement,或改用付費 Apple Developer Program 路線。

    安裝或啟動失敗

    • 確認簽名描述檔包含目標裝置。
    • 檢查 Developer Mode 及裝置信任。
    • 確認 IPA 支援目前 iOS 版本及架構。
    • 首次驗證時保持裝置連線。
    • Bundle ID 或 entitlement 變更後重新簽名。

    參考資料