iOS开发如何配置App在分享面板接收STL/OBJ等共享文件

该功能无系统实现限制，无需私有API，核心是正确配置自定义统一类型标识符（UTI）与文档类型声明，多数开发者无法生效的原因是STL、OBJ属于苹果未预置公开UTI的第三方格式，仅靠通用UTI配置无法被系统正确匹配。

核心配置步骤 #

1. Info.plist 声明支持的文件类型 #

需要先在UTImportedTypeDeclarations中声明你要支持的非系统预置格式，再通过CFBundleDocumentTypes绑定到应用，告诉系统你的应用可以处理这类文件。

• 声明STL、OBJ格式的导入UTI：

<key>UTImportedTypeDeclarations</key>
<array>
  <!-- STL格式声明 -->
  <dict>
    <key>UTTypeIdentifier</key>
    <string>com.standard.stl</string>
    <key>UTTypeDescription</key>
    <string>STL 3D Model</string>
    <key>UTTypeConformsTo</key>
    <array>
      <string>public.data</string>
      <string>public.3d-content</string>
    </array>
    <key>UTTypeTagSpecification</key>
    <dict>
      <key>public.filename-extension</key>
      <array><string>stl</string></array>
      <key>public.mime-type</key>
      <array>
        <string>application/sla</string>
        <string>application/vnd.ms-pki.stl</string>
      </array>
    </dict>
  </dict>
  <!-- OBJ格式声明 -->
  <dict>
    <key>UTTypeIdentifier</key>
    <string>com.wavefront.obj</string>
    <key>UTTypeDescription</key>
    <string>Wavefront OBJ 3D Model</string>
    <key>UTTypeConformsTo</key>
    <array>
      <string>public.data</string>
      <string>public.3d-content</string>
    </array>
    <key>UTTypeTagSpecification</key>
    <dict>
      <key>public.filename-extension</key>
      <array><string>obj</string></array>
      <key>public.mime-type</key>
      <array>
        <string>text/plain</string>
        <string>application/x-tgif</string>
      </array>
    </dict>
  </dict>
</array>

• 绑定文档类型到应用：

<key>CFBundleDocumentTypes</key>
<array>
  <dict>
    <key>CFBundleTypeName</key>
    <string>3D Model File</string>
    <key>CFBundleTypeRole</key>
    <string>Viewer</string>
    <key>LSHandlerRank</key>
    <string>Alternate</string>
    <key>LSItemContentTypes</key>
    <array>
      <string>com.standard.stl</string>
      <string>com.wavefront.obj</string>
    </array>
  </dict>
</array>

注意：LSHandlerRank不要设置为Owner，该值仅适用于你自己定义的专属文件格式，STL/OBJ是公共格式，设为Alternate即可，配置错误会导致系统匹配优先级异常。

2. 实现文件接收回调 #

配置完成后应用就会出现在对应格式文件的系统Share Sheet列表中，根据应用的生命周期实现回调拿到文件即可：

• iOS 13+ 采用SceneDelegate生命周期的应用，实现以下回调：

func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
    guard let fileURL = URLContexts.first?.url else { return }
    let fileExt = fileURL.pathExtension.lowercased()
    guard ["stl", "obj"].contains(fileExt) else { return }
    // 系统传入的文件存放在临时目录，长期使用需要拷贝到应用沙盒
    let docDir = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask)[0]
    let targetURL = docDir.appendingPathComponent(fileURL.lastPathComponent)
    try? FileManager.default.copyItem(at: fileURL, to: targetURL)
    // 后续执行文件解析、页面跳转等自定义逻辑
}

• 采用旧版AppDelegate生命周期的应用，实现application(_:open:options:)回调，取文件URL的逻辑与上述一致。

常见问题排查 #

• 不要直接给STL/OBJ套用public.data、public.content这类通用UTI，会导致应用在Share Sheet中的匹配优先级极低，甚至完全不展示
• 配置完成后如果未立刻生效，先重启设备，iOS的UTI注册存在系统缓存，重装应用有时无法触发缓存刷新
• MIME类型需要填写完整，不同来源分享的STL/OBJ文件携带的MIME类型可能不同，漏填会导致部分场景下应用无法出现在分享列表
• 不需要实现Share Extension来达成该效果，Share Extension用于自定义跨应用分享流程，让主应用出现在系统默认分享目标列表仅需上述文档类型配置即可，市面上所有支持接收STL/OBJ格式的3D类应用均采用该方案实现，无特殊权限要求。

内容的提问来源于stack exchange，提问作者Nick Bedford