UTS插件开发问题（iOS端），没有把interface.uts定义的自定义类型编入导致找不到方法

欢迎到专业群（ uni-app 官方技术交流群 1 ） 咨询，群中有相关专业的管理员和群友。

你描述的 “iOS 端找不到方法”，本质是 uts 插件在 iOS（Swift）侧的类型/导出约束没有被满足，导致编译出的原生接口和你在 interface.uts 里声明的自定义类型对不上，最终在 js 层调用时表现为“方法不存在”。

结合知识库，iOS 端对 uts 插件有几个明确的硬性限制，正好覆盖你这种“自定义类型作为方法参数”的场景：

1. iOS 环境只能导出 uts 中声明的自定义对象/类/方法，不能包含原生对象、平台专有类型。如果你的自定义类型内部包含了 iOS 原生对象（例如 AVFoundation、CoreLocation 等框架类型）或者未做 js 环境特殊处理的类型，就会导致接口无法正确编译暴露。
2. 函数参数不支持自定义 class 类型（官方文档明确限制）。如果你在 interface.uts 里声明了一个 class，然后又在 app-ios/index.uts 的方法里把这个 class 作为参数类型，iOS 端会无法正常导出这个方法。
3. 如果要用复杂类型作为参数/返回值，应该用 interface 或 type 而不是 class。iOS 要求返回值必须返回 interface 类型（如果涉及 class 实例），参数也建议用 type/interface 定义数据结构，而不是自定义 class。

针对你的情况，建议按下面步骤排查和修复：

1. 检查自定义类型的定义方式

把 interface.uts 里的自定义类型从 class 改成 type 或 interface：

// interface.uts  
// 错误（iOS 不支持 class 作为参数）：  
// export class MyParams { name: string = '' }  

// 正确：  
export type MyParams = {  
  name: string  
  success?: (res: MyResult) => void  
  fail?: (res: MyFail) => void  
}  

export type MyResult = {  
  code: number  
}

本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent
然后在 app-ios/index.uts 里实现：

import { MyParams, MyResult } from "../interface.uts"  

export function myApi(options: MyParams): void {
// iOS 原生实现
let res: MyResult = { code: 0 }
options.success?.(res)
}

> **本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用[uni-agent](https://uniapp.dcloud.net.cn/ai/)**  

### 2. 避免在参数中使用原生对象  
确认你的自定义类型里没有嵌入 iOS 原生类型（如 `NSObject`、`UIView`、AVFoundation 类型等）。如果必须传原生对象，应该：  
- 在 iOS 端内部处理，不暴露给 js 层  
- 或者只暴露简单的 string/number/boolean 等基础类型和 uts 声明的 type/interface  

### 3. 确保正确 import 自定义类型  
`app-ios/index.uts` 里必须显式 import `interface.uts` 中定义的类型：
```ts  
import { MyParams, MyResult } from "../interface.uts"

本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent
如果路径或导入方式不对，iOS 编译时也会找不到类型，进而导致方法签名无法生成。

4. 重新打自定义基座

iOS 端 uts 插件涉及原生代码编译，修改后必须重新打 iOS 自定义调试基座 才能生效。云端打包日志里如果出现“未使用原生插件”之类的提示，说明插件没被正确编入；正常包含 uts 插件的 iOS 基座打包会慢一些，并且 IPA 体积会明显增大。

5. 如果仍然报错

提供一下关键信息，我可以帮你更精确地定位：

• interface.uts 里自定义类型的完整定义
• app-ios/index.uts 里方法的签名和 import 语句
• 具体的报错信息（编译报错 or 运行时“找不到方法”的日志）

参考文档：

• uts 插件 interface.uts 编写规范
• iOS uts 导出 class 的使用限制
• uni-app 环境下的导出限制

按官方 iOS 的导出规范调整后，一般就能解决“自定义类型导致找不到方法”的问题。