capacitor-baidu-location 0.0.1

package/ios/Sources/CPBaiduLocationPlugin/CPBaiduLocation.swift

@@ -0,0 +1,646 @@
+import Foundation
+@_exported import BMKLocationKit
+import CoreLocation
+import Network
+
+/**
+ * 百度地图定位插件iOS端实现类
+ * 负责处理百度地图定位的核心逻辑，包括定位权限管理、AK验证、定位请求等
+ */
+@objc public class CPBaiduLocation: NSObject, BMKLocationAuthDelegate, BMKLocationManagerDelegate, CLLocationManagerDelegate {
+    
+    /**
+     * 插件配置对象
+     */
+    private var config: CPBaiduLocationConfig
+    
+    /**
+     * 系统定位管理器（用于权限请求和系统级定位）
+     */
+    private var clLocationManager: CLLocationManager = CLLocationManager()
+    
+    /**
+     * 定位结果回调（弱引用自身避免循环引用）
+     */
+    private var completion: (([String: Any]) -> Void)?
+    
+    /**
+     * 标记是否已执行回调（防止重复调用）
+     */
+    private var isCallbackInvoked = false
+    
+    // MARK: - 状态管理
+    
+    /**
+     * API Key
+     */
+    private var ak: String?
+    
+    /**
+     * AK验证状态
+     */
+    private var isAKValidated = false
+    
+    /**
+     * 坐标类型
+     * 默认值：BMKLocationCoordinateType.BMK09LL（百度经纬度坐标）
+     */
+    private var coordinateType: BMKLocationCoordinateType = .BMK09LL
+    
+    /**
+     * AK验证回调队列
+     * 存储等待AK验证结果的回调
+     */
+    private var akValidationCallbacks: [(Bool, Int?, String?) -> Void] = []
+    
+    /**
+     * 定位权限回调队列
+     * 存储等待定位权限结果的回调
+     */
+    private var locationPermissionCallbacks: [(String) -> Void] = []
+    
+    // MARK: - 网络状态监听
+    
+    /**
+     * 网络状态监视器
+     */
+    private var networkMonitor: NWPathMonitor?
+    
+    /**
+     * 当前网络路径
+     */
+    private var networkPath: NWPath?
+    
+    /**
+     * 是否已启动网络监听
+     */
+    private var isMonitoringNetwork = false
+    
+    /**
+     * 百度定位管理器（持强引用避免提前释放）
+     * 懒加载，确保在需要时才初始化
+     */
+    private lazy var bmkLocationManager: BMKLocationManager = {
+        // 初始化并配置定位管理器
+        let manager = BMKLocationManager()
+        manager.delegate = self
+        manager.coordinateType = coordinateType // 坐标类型
+        manager.desiredAccuracy = kCLLocationAccuracyBest // 默认定位精度
+        manager.activityType = .automotiveNavigation // 默认定位场景
+        manager.pausesLocationUpdatesAutomatically = false // 默认不被系统自动暂停定位
+        manager.allowsBackgroundLocationUpdates = true // 允许后台定位，需要在xcode开启配置
+        manager.locationTimeout = 10 // 定位超时时间，单位：秒
+        manager.reGeocodeTimeout = 10 // 逆地理编码超时时间，单位：秒
+        return manager
+    }()
+    
+    /**
+     * 使用配置对象初始化
+     * @param config 配置对象
+     */
+    public init(config: CPBaiduLocationConfig) {
+        self.config = config
+        super.init()
+        clLocationManager.delegate = self
+    }
+    
+    /**
+     * 默认初始化
+     */
+    override init() {
+        self.config = CPBaiduLocationConfig(from: nil)
+        super.init()
+        clLocationManager.delegate = self
+    }
+    
+
+    
+    // MARK: - AK管理
+    /**
+     * 设置百度地图API Key
+     * @param ak API Key
+     * @param completion 验证结果回调
+     */
+    @objc public func setAK(_ ak: String, completion: @escaping ([String: Any]) -> Void) {
+        if isAKValidated || ak == self.ak {
+            completion([
+                "success": true,
+            ])
+        }
+        // 存储API Key
+        self.ak = ak
+        
+        // 重置验证状态
+        isAKValidated = false
+        
+        // 自动设置同意隐私协议
+        if !BMKLocationAuth.sharedInstance().isAgreePrivacy {
+            BMKLocationAuth.sharedInstance().setAgreePrivacy(true)
+        }
+        
+        // 添加到回调队列
+        akValidationCallbacks.append { success, errorCode, errorMessage in
+            var result: [String: Any] = [
+                "success": success
+            ]
+            
+            if let errorCode = errorCode {
+                result["errorCode"] = errorCode
+            }
+            
+            if let errorMessage = errorMessage {
+                result["errorMessage"] = errorMessage
+            }
+            
+            completion(result)
+        }
+        
+        startNetworkMonitoring()
+        
+        // 触发AK验证
+        BMKLocationAuth.sharedInstance().checkPermision(withKey: ak, authDelegate: self)
+    }
+    
+    // MARK: - 坐标类型管理
+    /**
+     * 辅助方法：将字符串类型的坐标类型转换为BMKLocationCoordinateType枚举类型
+     * @param type 坐标类型字符串
+     * @return BMKLocationCoordinateType枚举类型
+     */
+    private func coordinateTypeFromString(_ type: String) -> BMKLocationCoordinateType {
+        switch type {
+        case "BD09LL":
+            return .BMK09LL // 百度经纬度坐标
+        case "BD09MC":
+            return .BMK09MC // 百度墨卡托米制坐标
+        case "GCJ02":
+            return .GCJ02 // 国测局坐标
+        case "WGS84":
+            return .WGS84 // WGS84坐标
+        default:
+            return .BMK09LL // 默认百度经纬度坐标
+        }
+    }
+    
+    /**
+     * 设置坐标类型
+     * @param type 坐标类型
+     * @param completion 设置结果回调
+     */
+    @objc public func setCoordinateType(_ type: String, completion: @escaping () -> Void) {
+        // 根据坐标类型设置定位参数
+        self.coordinateType = coordinateTypeFromString(type)
+        if bmkLocationManager != nil {
+            bmkLocationManager.coordinateType = coordinateType
+        }
+        completion()
+    }
+    
+    /**
+     * 获取当前坐标类型
+     * @return 当前坐标类型
+     */
+    @objc public func getCoordinateType() -> String {
+        switch coordinateType {
+        case .BMK09LL:
+            return "BD09LL"
+        case .BMK09MC:
+            return "BMK09MC"
+        case .GCJ02:
+            return "GCJ02"
+        case .WGS84:
+            return "WGS84"
+        default:
+            return "BD09LL"
+        }
+    }
+    
+    // MARK: - 权限管理
+    /**
+     * 检查定位权限状态
+     * @return 权限状态结果
+     */
+    @objc public func checkPermission() -> [String: Any] {
+        let status = CLLocationManager.authorizationStatus()
+        
+        var statusString: String
+        var hasPermission = false
+        
+        switch status {
+        case .authorizedWhenInUse, .authorizedAlways:
+            statusString = "granted"
+            hasPermission = true
+        case .denied, .restricted:
+            statusString = "denied"
+            hasPermission = false
+        case .notDetermined:
+            statusString = "notDetermined"
+            hasPermission = false
+        @unknown default:
+            statusString = "unknown"
+            hasPermission = false
+        }
+        
+        return [
+            "success": true,
+            "hasPermission": hasPermission,
+            "status": statusString
+        ]
+    }
+    
+    /**
+     * 请求定位权限
+     * @param completion 权限请求结果回调
+     */
+    @objc public func requestPermission(completion: @escaping ([String: Any]) -> Void) {
+        let status = CLLocationManager.authorizationStatus()
+        
+        if status == .notDetermined {
+            // 请求权限
+            locationPermissionCallbacks.append { statusString in
+                let hasPermission = statusString == "granted"
+                completion([
+                    "success": true,
+                    "granted": hasPermission,
+                    "status": statusString
+                ])
+            }
+            clLocationManager.requestWhenInUseAuthorization()
+        } else {
+            // 直接返回当前状态
+            let checkResult = self.checkPermission()
+            completion([
+                "success": true,
+                "granted": checkResult["hasPermission"] as? Bool ?? false,
+                "status": checkResult["status"] as? String ?? "unknown"
+            ])
+        }
+    }
+    
+    // MARK: - 定位
+    /**
+     * 获取当前位置信息
+     * @param needAddress 是否需要地址信息
+     * @param needLocationDescribe 是否需要位置描述
+     * @param completion 定位结果回调（主线程执行）
+     */
+    @objc public func getCurrentPosition(needAddress: Bool, needLocationDescribe: Bool, completion: @escaping ([String: Any]) -> Void) {
+        // 重置状态
+        isCallbackInvoked = false
+        self.completion = completion
+        
+        // 检查前置条件
+        checkPreconditions { [weak self] isReady, errorCode, errorMessage in
+            guard let strongSelf = self else { return }
+            
+            if !isReady {
+                // 前置条件不满足，返回错误
+                let result: [String: Any] = [
+                    "latitude": 0.0,
+                    "longitude": 0.0,
+                    "accuracy": 0.0,
+                    "errorCode": errorCode ?? -1,
+                    "errorMessage": errorMessage ?? "定位前置条件不满足"
+                ]
+                strongSelf.invokeCompletion(with: result)
+            } else {
+                // 前置条件满足，执行定位
+                strongSelf.performLocationRequest(needAddress: needAddress, needLocationDescribe: needLocationDescribe)
+            }
+        }
+    }
+    
+    /**
+     * 检查定位前置条件
+     * @param completion 检查结果回调
+     */
+    private func checkPreconditions(completion: @escaping (Bool, Int?, String?) -> Void) {
+        // 检查定位权限
+        let permissionResult = checkPermission()
+        if !(permissionResult["hasPermission"] as? Bool ?? false) {
+            completion(false, -3, "定位权限未授权!")
+            return
+        }
+        
+        // 检查系统定位服务是否开启
+        if !CLLocationManager.locationServicesEnabled() {
+            completion(false, 2, "定位服务未开启!")
+            return
+        }
+        
+        // 检查AK是否已验证
+        if isAKValidated {
+            completion(true, nil, nil)
+            return
+        } else {
+            completion(false, -1, "未设置AK!")
+            return
+        }
+    }
+    
+    /**
+     * 执行定位请求
+     * @param needAddress 是否需要地址信息
+     * @param needLocationDescribe 是否需要位置描述
+     */
+    private func performLocationRequest(needAddress: Bool, needLocationDescribe: Bool) {
+        // 请求单次定位
+        bmkLocationManager.requestLocation(withReGeocode: needAddress, withNetworkState: true) { [weak self] (location, state, error) in
+            guard let strongSelf = self else { return }
+            // 构建定位结果
+            let result = strongSelf.buildLocationResult(
+                location: location,
+                error: error,
+                needAddress: needAddress,
+                needLocationDescribe: needLocationDescribe
+            )
+            // 执行回调（确保仅调用一次）
+            strongSelf.invokeCompletion(with: result)
+        }
+    }
+    
+    // MARK: - 其他方法
+    /**
+     * 构建定位结果字典
+     * @param location 百度定位信息对象
+     * @param error 定位错误（如果有）
+     * @param needAddress 是否需要地址信息
+     * @param needLocationDescribe 是否需要位置描述
+     * @return 定位结果字典，包含经纬度、精度、地址信息等
+     */
+    private func buildLocationResult(
+        location: BMKLocation?,
+        error: Error?,
+        needAddress: Bool,
+        needLocationDescribe: Bool
+    ) -> [String: Any] {
+        // 初始化默认结果（兜底值）
+        var result: [String: Any] = [
+            "latitude": 0.0,
+            "longitude": 0.0,
+            "accuracy": 0.0,
+            "errorCode": -1,
+            "errorMessage": "定位失败",
+            "type": "baidu" // 标记为百度定位结果
+        ]
+        
+        // 处理错误优先
+        if let error = error {
+            let nsError = error as NSError
+            let errorCode = nsError.code
+            result["errorCode"] = errorCode
+            result["errorMessage"] = nsError.localizedDescription
+            
+            let bmkError = BMKLocationErrorCode(rawValue: nsError.code)
+            if (bmkError != nil) {
+                print("定位错误来自百度SDK")
+            }
+            return result
+        }
+        
+        // 处理定位成功
+        guard let bmkLocation = location, let clLocation = bmkLocation.location else {
+            result["errorMessage"] = "未获取到位置信息"
+            return result
+        }
+        
+        // 基础定位信息
+        result["latitude"] = clLocation.coordinate.latitude
+        result["longitude"] = clLocation.coordinate.longitude
+        result["accuracy"] = clLocation.horizontalAccuracy
+        result["errorCode"] = 0
+        result["errorMessage"] = "定位成功"
+        
+        // 地址信息（按需添加）
+        if needAddress, let rgcData = bmkLocation.rgcData {
+            result["address"] = rgcData.address ?? ""
+            result["country"] = rgcData.country ?? ""
+            result["province"] = rgcData.province ?? ""
+            result["city"] = rgcData.city ?? ""
+            result["district"] = rgcData.district ?? ""
+            result["street"] = rgcData.street ?? ""
+            result["adcode"] = rgcData.adCode ?? ""
+            result["town"] = rgcData.town ?? ""
+        }
+        
+        // 位置描述（按需添加）
+        if needLocationDescribe, let rgcData = bmkLocation.rgcData, let poiRegion = rgcData.poiRegion {
+            result["locationDescribe"] = "\(poiRegion.name ?? "") \(poiRegion.directionDesc ?? "")"
+        }
+        
+        return result
+    }
+    
+    /**
+     * 执行回调（确保主线程+仅执行一次）
+     * @param result 定位结果字典
+     */
+    private func invokeCompletion(with result: [String: Any]) {
+        guard !isCallbackInvoked else { return }
+        isCallbackInvoked = true
+        
+        // 切主线程执行回调（避免UI操作崩溃）
+        DispatchQueue.main.async { [weak self] in
+            self?.completion?(result)
+            // 清理资源
+            self?.cleanup()
+        }
+    }
+    
+    /**
+     * 清理定位资源
+     * 释放回调引用，避免循环引用
+     */
+    private func cleanup() {
+        completion = nil
+    }
+    
+    // MARK: - 网络状态监听
+    /**
+     * 启动网络状态监听
+     */
+    private func startNetworkMonitoring() {
+        guard !isMonitoringNetwork else { return }
+        
+        networkMonitor = NWPathMonitor()
+        networkPath = networkMonitor?.currentPath
+        
+        if networkPath?.status == .satisfied {
+            return
+        }
+        
+        networkMonitor?.pathUpdateHandler = { [weak self] path in
+            guard let strongSelf = self else { return }
+            strongSelf.networkPath = path
+            
+            // 当网络从不可用变为可用，且AK未验证成功时，重新触发AK验证
+            if path.status == .satisfied && !strongSelf.isAKValidated, let ak = strongSelf.ak {
+                print("网络恢复，重新验证AK")
+                DispatchQueue.main.async {
+                    BMKLocationAuth.sharedInstance().checkPermision(withKey: ak, authDelegate: strongSelf)
+                }
+            }
+        }
+        
+        // 启动监听
+        let queue = DispatchQueue(label: "com.baidu.location.network")
+        networkMonitor?.start(queue: queue)
+        isMonitoringNetwork = true
+        print("网络状态监听已启动")
+    }
+    
+    /**
+     * 停止网络状态监听
+     */
+    private func stopNetworkMonitoring() {
+        guard isMonitoringNetwork else { return }
+        
+        networkMonitor?.cancel()
+        networkMonitor = nil
+        networkPath = nil
+        isMonitoringNetwork = false
+        print("网络状态监听已停止")
+    }
+    
+    // MARK: - CLLocationManagerDelegate
+    /**
+     * 定位权限状态变化回调 (iOS 14-)
+     * @param manager 定位管理器
+     * @param status 权限状态
+     */
+    @objc public func locationManager(_ manager: CLLocationManager, didChangeAuthorization status: CLAuthorizationStatus) {
+        handleLocationManager(manager, didChangeAuthorization: status)
+    }
+    
+    /**
+     * 定位权限状态变化回调 (iOS 14+ 推荐使用)
+     * @param manager 定位管理器
+     */
+    @available(iOS 14.0, *)
+    @objc public func locationManagerDidChangeAuthorization(_ manager: CLLocationManager) {
+        handleLocationManager(manager, didChangeAuthorization: manager.authorizationStatus)
+    }
+    
+    // MARK: - 定位权限状态变化处理
+    private func handleLocationManager(_ manager: CLLocationManager, didChangeAuthorization status: CLAuthorizationStatus) {
+        // 执行所有等待的权限回调
+        let callbacks = locationPermissionCallbacks
+        locationPermissionCallbacks.removeAll()
+        
+        let statusString: String
+        switch status {
+        case .authorizedWhenInUse, .authorizedAlways:
+            statusString = "granted"
+            // 检查精确定位状态（iOS 14+）
+            if #available(iOS 14.0, *) {
+                let accuracyStatus = manager.accuracyAuthorization
+                if accuracyStatus == .reducedAccuracy {
+                    // 精确定位未开启，引导用户跳转到系统设置
+                    // showPreciseLocationSettingAlert()
+                }
+            }
+        case .denied, .restricted:
+            statusString = "denied"
+        case .notDetermined:
+            statusString = "notDetermined"
+        @unknown default:
+            statusString = "unknown"
+        }
+        
+        // 执行回调
+        callbacks.forEach { $0(statusString) }
+    }
+    
+    // MARK: - 请求精确定位权限（iOS 14+）
+    @available(iOS 14.0, *)
+    private func requestPreciseLocationAuthorization() {
+        // 检查当前精确定位权限
+        let accuracyStatus = clLocationManager.accuracyAuthorization
+        switch accuracyStatus {
+        case .fullAccuracy:
+            // 已授权精确定位：可启动百度定位
+            print("accuracyStatus: fullAccuracy")
+        case .reducedAccuracy:
+            // 仅大致定位：请求临时精确定位（需 Info.plist 配置 PurposeKey）
+            clLocationManager.requestTemporaryFullAccuracyAuthorization(withPurposeKey: "LocationTempUsage")
+        @unknown default:
+            print("accuracyStatus: \(accuracyStatus)")
+        }
+    }
+    
+    // MARK: - BMKLocationAuthDelegate
+    /**
+     * AK验证状态变化回调
+     * @param iError 错误号 : 为0时验证通过，具体参加BMKLocationAuthErrorCode
+     */
+    public func onCheckPermissionState(_ iError: BMKLocationAuthErrorCode) {
+        var success = false
+        var errorCode = iError.rawValue
+        var errorMessage: String?
+        
+        // 如果网络状态为未确定（用户还未选择网络权限），则不执行回调，等待网络状态变化后重试
+        if let networkPath = networkPath, networkPath.status != .satisfied {
+            return
+        }
+        
+        switch iError {
+        case .success:
+            success = true
+            isAKValidated = true
+            errorMessage = "AK验证成功"
+            ak = nil
+            // 触发懒加载（有个bug，之后再初始化就无法定位成功）
+            print("allowsBackgroundLocationUpdates = \(bmkLocationManager.allowsBackgroundLocationUpdates)")
+            // 验证成功，停止网络监听
+            stopNetworkMonitoring()
+        case .networkFailed:
+            success = false
+            isAKValidated = false
+            errorMessage = "网络错误导致AK验证失败"
+        case .failed:
+            success = false
+            isAKValidated = false
+            errorMessage = "KEY非法导致AK验证失败"
+        default:
+            success = false
+            isAKValidated = false
+            errorMessage = "未知AK验证错误"
+        }
+        
+        // 执行所有等待的回调
+        let callbacks = akValidationCallbacks
+        akValidationCallbacks.removeAll()
+        callbacks.forEach { $0(success, errorCode, errorMessage) }
+    }
+    
+    // MARK: - BMKLocationManagerDelegate
+    /**
+     * 定位失败代理回调（系统级错误触发）
+     * @param manager 定位管理器
+     * @param error 错误信息
+     */
+    public func bmkLocationManager(_ manager: BMKLocationManager, didFailWithError error: Error?) {
+        // 使用统一的错误处理逻辑
+        let result = buildLocationResult(
+            location: nil,
+            error: error,
+            needAddress: false,
+            needLocationDescribe: false
+        )
+        
+        // 执行回调（防止重复）
+        invokeCompletion(with: result)
+    }
+    
+    public func bmkLocationManager(_ manager: BMKLocationManager, didChange status: CLAuthorizationStatus) {
+    }
+    
+    public func bmkLocationManagerDidChangeAuthorization(_ manager: BMKLocationManager) {
+    }
+    
+    deinit {
+        // 确保网络监听已停止
+        stopNetworkMonitoring()
+        print("CPBaiduLocation实例已销毁")
+    }
+}

package/ios/Sources/CPBaiduLocationPlugin/CPBaiduLocationConfig.swift

@@ -0,0 +1,38 @@
+import Foundation
+import Capacitor
+
+/**
+ * 百度地图定位插件配置类
+ * 集中管理所有配置项，提供类型安全的访问方式
+ */
+public class CPBaiduLocationConfig {
+    
+    /**
+     * iOS平台百度地图API Key
+     */
+    private var _iOSAK: String?
+    
+    // MARK: - Getters and Setters
+    
+    /**
+     * iOS平台百度地图API Key
+     */
+    public var iOSAK: String? {
+        get {
+            return _iOSAK
+        }
+        set {
+            _iOSAK = newValue
+        }
+    }
+    
+    /**
+     * 从Capacitor配置中初始化配置对象
+     */
+    convenience public init(from config: PluginConfig?) {
+        self.init()
+        if let config = config {
+            self.iOSAK = config.getString("iOSAK")
+        }
+    }
+}