iOS常见问题

一、上传问题

1、关联域名(Associated Domains)配置错误

上传应用时候会如图错误提示 这是因为iOS包没有配置 Associated Domains 导致的，这将会导致一键拉起和闪装功能的失效，解决方案可以根据一键拉起中苹果网站的配置和Xcode中的配置是否正确来解决。（我们提供了两个 Associated Domains，若您只配置了其中一个，我们会在上传包时对您进行提醒，建议两个都配置）

2、Bundle Identifier不能为通配证书

上传应用时候会如图错误提示 这是IPA打包时候用的是通用描述文件导致的，这个可以大多发生在非正常Xcode流程打包，或重签名导致。可以让iOS技术人员重新用Xcode打包，正常导出即可。

二、其他问题

1、通用链接在 iOS 11.2+ 中，偶尔会出现失效，无法唤醒拉起 app，为什么？

这是因为苹果 iOS 11.2+ 出现的系统 bug 导致的（偶然发生的），解决方法“删除 app，重启设备，重新安装 app”,苹果目前还没有完全解决这个问题，我们将持续跟进。

2、iOS无法获取自定义参数？

（1）检查是否按照文档集成相关代码 （2）是否将集成好sdk 的ipa包上传到Xinstall (ios上传包是方便测试，上传第一个包后可以通过xcode安装的方式进行调试) （3）测试时需要将已安装的App卸载，不能覆盖安装测试 （测试时可以使用Xinstall 控制中心提供测试网页测试- 在线测试）

3、为什么Universal link 无法正常调起？

这个文章可以解决99%以上问题 iOS Universal link验证失败，该如何配置-三步完成

4、为什么SDK的方法和文档中的方法不一致

确保你使用的是最新SDK版本。

pod方式导入的客户，由于pod install本身框架限制时候，默认不会去更新pod库，所以使用的还是老版本，你可以通过pod repo update 来完成本地pod仓库的更新，然后进入项目再次pod install 后就可以完成SDK更新了。

直接通过SDK下载方式导入的客户，可以直接在 iOS集成中下载最新SDK重新导入项目即可。

5、使用Swift开发时如何桥接SDK

由于 Xinstall SDK 使用 Objective-C 进行编写，所以当您工程中的 Swift 文件需要调用 SDK 内的方法时，需要先建立一个桥接文件，才能正常进行调用。

如何新建桥接文件

• 若您的工程中还没有任何 Swift 文件，此时若创建一个 Swift 文件，XCode 会自动提示是否要创建一个桥接文件，此时直接点击【Create Bridging Header】按钮即可：

  

• 若您的工程中已经存在 Swift 文件，此时需要手动创建一个桥接文件，文件类型选择 [ Header File ]：

  

  然后使用 工程名-Bridging-Header.h 的格式进行命名并创建：

  

配置桥接文件

• 如果桥接文件是 XCode 自动提示创建生成，则无需进行配置

• 如果桥接文件是手动创建生成，则需要前往 [ Build Settings ] 配置下，先将 Precompile Bridging Header 设置为 Yes，然后找到 Objective-C Bridging Header 选项，双击一下，并将刚才的桥接文件从左侧拖入即可：

  

在桥接文件中导入 XinstallSDK 的引用

在桥接文件中直接 #import "XinstallSDK.h" 后，即可在 Swift 文件中直接使用 XinstallSDK 了（无需 import）：