# 原生联调

宿主原生应用是Objective-C/Swift代码，在Xcode中运行。uni-app x应用是uvue/uts代码，在HBuilderX中运行。但两者经常需要联调。

得益于uts的编译产物就是Swift，所以uni-app x可以和原生应用混编运行，联调debug。

有两种方案：

在HBuilderX 4.81以前，支持把宿主原生应用变成HBuilderX的自定义基座。这种方式需要把宿主应用先打包为带有uni-app x调试模块的基座(.ipa文件)，再运行uni-app x项目，无法动态修改宿主应用的原生代码。
从HBuilderX 4.81+，支持宿主原生工程直接拖入HBuilderX中，和uni-app x项目进行源码级联编联调。

无论哪种方案1还是方案2，首先要对宿主原生应用进行一些配置

# Xcode 配置项目

对宿主原生项目配置，目的是为了加入uni-app x的调试模块，并对uni-app x调试模块所需的依赖进行配置。

下载uni-app x原生SDK后，将DCloudDebugServe.xcframework添加到原生工程中。
将原生工程中Target的名称改为UniAppX。如图：
在工程Info.plist下添加UIFileSharingEnabled节点，值设置为true。如图：
填写Display Name(建议与manifest.json中name值一致)、Build(建议与manifest.json中versionCode一致)、Version(建议与manifest.json中versionName值一致)字段。如图：
在工程Info.plist下添加uniapp-x节点，在节点中配置appid(必须与manifest.json中appid值一致)以及ipatype(在HBuilderX中调试需要设置为1),如图：

# 方案1：把宿主应用打包为HBuilderX的自定义基座。

思路：把宿主原生工程打包为ipa，成为自定义基座。然后在HBuilderX中运行uni-app x时，选择这个自定义基座，运行到手机上。

如果您不了解什么是运行基座、标准基座、自定义基座，这些概念，请参考文档

# 原生工程生成自定义基座

检查Target -> Info -> uniapp-x节点下的uniRuntimeVersion与HBuilder X版本号是否一致，如有差异建议更新为相同版本。
在Xcode菜单栏中，选择Product -> Archive 根据提示导出ipa文件

# 将自定义基座添加到uni-app x 项目

将生成的ipa文件重命名为iOS_debug.ipa
将iOS_debug.ipa拷贝到uni-app x项目的unpackage/debug目录下
点击 运行 -> 运行到iOS App基座，勾选使用自定义基座运行

运行成功后，在手机自定义基座中打开uni-app x应用，HBuilderX控制台可以看到运行log。在HBuilderX中修改uni-app x代码，可以在手机端基座中热刷生效。

# 方案2：原生工程联编联调

HBuilderX4.81+

注意：需要将 HBuilderX 和 uni-app x SDK 都升级到4.81或以上版本

在前述Xcode 配置项目配置完成后，可以通过Xcode直接运行到手机上。

然后切换到 HBuilderX 点击运行按钮->运行到iOS App基座，勾选使用自定义基座运行->原生工程基座，在基座位置处输入Xcode编译产物(UniAppX.app)的路径后，点击运行。

# 如何获取基座位置

编译成功后，在 Xcode 左侧的项目导航器 (Navigator) 中，切换到 Products 目录。找到你的项目名称对应的 .app文件。右键点击它，选择 Show in Finder 或将其拖入到终端中获取路径。

# 调试原生工程中的uvue页面

在HBuilder X完成运行基座后，通过 HBuilder X 控制台右上角的红色虫子按钮点击开启uts调试(jscore)后通过双击或右键在uvue页面中添加断点调试。断点调试详情参考 uni-app x iOS uts 调试中的 uni-app x jscore调试 部分。

# 调试原生主工程或UTS插件

在HBuilder X完成运行基座后，将Xcode中的原生工程根目录拖入到HBuilderX的项目管理器中，通过 HBuilder X 控制台右上角的红色虫子按钮点击开启uts调试(swift)后通过双击或右键在原生代码中添加断点。断点调试详情参考uni-app x iOS uts 调试中的 uni-app x swift调试 部分。