如何开发iOS版Cordova插件？ | Cordova移动应用开发全教程

Cordova插件开发iOS实战指南

Cordova插件开发的核心在于桥接JavaScript与原生iOS代码，实现WebView无法直接访问的设备功能,以下是详细开发流程：

开发环境准备

1. 基础工具链

   npm install -g cordova ios-sim ios-deploy

2. 创建测试工程

   cordova create MyDemo com.example.mydemo MyDemo
   cd MyDemo
   cordova platform add ios

创建基础插件结构

1. 生成插件模板

   plugman create --name CameraPlus --plugin_id cordova-plugin-camera-plus --plugin_version 1.0.0

2. 关键文件结构

   CameraPlus/
   ├── src/
   │   └── ios/
   │       └── CameraPlus.swift
   ├── www/
   │   └── CameraPlus.js
   └── plugin.xml

编写iOS原生代码（Swift示例）

import AVFoundation
@objc(CameraPlus) class CameraPlus: CDVPlugin {
    @objc(openCamera:)
    func openCamera(_ command: CDVInvokedUrlCommand) {
        guard AVCaptureDevice.authorizationStatus(for: .video) == .authorized else {
            sendErrorResult("Camera permission denied", command)
            return
        }
        DispatchQueue.main.async {
            let picker = UIImagePickerController()
            picker.sourceType = .camera
            picker.delegate = self
            self.viewController.present(picker, animated: true)
        }
    }
    private func sendErrorResult(_ message: String, _ command: CDVInvokedUrlCommand) {
        let pluginResult = CDVPluginResult(
            status: CDVCommandStatus_ERROR,
            messageAs: message
        )
        self.commandDelegate.send(pluginResult, callbackId: command.callbackId)
    }
}
// 实现UIImagePickerControllerDelegate处理回调
extension CameraPlus: UIImagePickerControllerDelegate, UINavigationControllerDelegate {
    func imagePickerController(_ picker: UIImagePickerController, 
                               didFinishPickingMediaWithInfo info: [UIImagePickerController.InfoKey : Any]) {
        // 获取图片数据并返回Base64
        if let image = info[.originalImage] as? UIImage,
           let data = image.jpegData(compressionQuality: 0.9) {
            let base64String = data.base64EncodedString()
            let pluginResult = CDVPluginResult(
                status: CDVCommandStatus_OK,
                messageAs: base64String
            )
            // 假设通过commandContext传递callbackId
            self.commandDelegate?.send(pluginResult, callbackId: self.currentCallbackId)
        }
        picker.dismiss(animated: true)
    }
}

JavaScript桥接层实现

www/CameraPlus.js 文件：

module.exports = {
    openCamera: function(success, failure) {
        exec(success, failure, 'CameraPlus', 'openCamera', []);
    }
};

关键配置：plugin.xml

<plugin xmlns="http://apache.org/cordova/ns/plugins/1.0" id="cordova-plugin-camera-plus">
    <name>CameraPlus</name>
    <js-module src="www/CameraPlus.js" name="CameraPlus">
        <clobbers target="cordova.plugins.CameraPlus" />
    </js-module>
    <platform name="ios">
        <config-file target="config.xml" parent="/">
            <feature name="CameraPlus">
                <param name="ios-package" value="CameraPlus" />
            </feature>
        </config-file>
        <source-file src="src/ios/CameraPlus.swift" />
        <!-- 相机权限声明 -->
        <config-file target="-Info.plist" parent="NSCameraUsageDescription">
            <string>需要相机权限来拍照</string>
        </config-file>
    </platform>
</plugin>

高级开发技巧

1. 线程安全实践

   // 确保UI操作在主线程执行
   DispatchQueue.main.async {
       self.viewController.present(alert, animated: true)
   }

2. Swift-OC混合开发

   // CameraPlus-Bridging-Header.h
   #import <Cordova/CDV.h>

3. TypeScript支持

   declare global {
       interface Window {
           CameraPlus: {
               openCamera(): Promise<string>;
           };
       }
   }

调试与优化

1. 日志输出技巧

   

   NSLog(@"CameraPlus: Received %@", command.arguments[0]);

2. Xcode调试重点

   • 设置OS_ACTIVITY_MODE = disable过滤系统日志
   • 使用po [[UIWindow keyWindow] recursiveDescription]调试WebView层级

3. 性能优化点

   • 大图片传输使用CDVPluginResult的arrayBuffer类型
   • 视频处理采用分块传输

发布与维护

1. NPM发布流程

   npm login
   npm publish --access public

2. 版本管理规范

   2.3 → [主版本].[功能更新].[Bug修复]

3. API兼容性策略

   

   • 废弃方法保留至少两个版本
   • 使用@deprecated标注旧API

避坑指南：iOS 14+的WKWebView限制
若插件涉及本地文件访问，需在config.xml添加：

<preference name="AllowUntrustedCerts" value="true" />
<preference name="InterceptRemoteRequests" value="all" />

实战思考：您认为在Cordova插件中处理大文件传输时，采用Base64编码还是分块传输更优？在您的实际项目中遇到过哪些跨平台兼容性问题？欢迎分享您的解决方案！