expo-gaode-map 2.2.7-next.0 → 2.2.7

package/ios/ExpoGaodeMapModule.swift

@@ -16,81 +16,86 @@ public class ExpoGaodeMapModule: Module {
     private var locationManager: LocationManager?
     /// 权限管理器实例
     private var permissionManager: PermissionManager?
-    /// 隐私协议是否已同意（模块级别跟踪）
-    private static var privacyAgreed: Bool = false
-    /// 隐私同意持久化 Key
-    private static let privacyDefaultsKey = "expo_gaode_map_privacy_agreed"
+    
+    // MARK: - 私有辅助方法
+    
+    /**
+     * 尝试从 Info.plist 读取并设置 API Key
+     * @return 是否成功设置 API Key
+     */
+    private func trySetupApiKeyFromPlist() -> Bool {
+        if AMapServices.shared().apiKey == nil || AMapServices.shared().apiKey?.isEmpty == true {
+            if let plistKey = Bundle.main.infoDictionary?["AMapApiKey"] as? String, !plistKey.isEmpty {
+                AMapServices.shared().apiKey = plistKey
+                AMapServices.shared().enableHTTPS = true
+                print("✅ ExpoGaodeMap: 从 Info.plist 读取并设置 AMapApiKey 成功")
+                return true
+            } else {
+                print("⚠️ ExpoGaodeMap: Info.plist 未找到 AMapApiKey")
+                return false
+            }
+        }
+        return true // 已经设置过了
+    }
+    
+    /**
+     * 尝试启动预加载（检查 API Key 后）
+     * @param delay 延迟时间（秒）
+     * @param poolSize 预加载池大小
+     */
+    private func tryStartPreload(delay: Double = 1.0, poolSize: Int = 1) {
+        if let apiKey = AMapServices.shared().apiKey, !apiKey.isEmpty {
+            DispatchQueue.main.asyncAfter(deadline: .now() + delay) {
+                let status = MapPreloadManager.shared.getStatus()
+                let isPreloading = (status["isPreloading"] as? Bool) ?? false
+                
+                if !MapPreloadManager.shared.hasPreloadedMapView() && !isPreloading {
+                    print("🚀 ExpoGaodeMap: 自动启动地图预加载")
+                    MapPreloadManager.shared.startPreload(poolSize: poolSize)
+                }
+            }
+        } else {
+            print("⚠️ ExpoGaodeMap: API Key 未设置，跳过自动预加载")
+        }
+    }
     
     public func definition() -> ModuleDefinition {
         Name("ExpoGaodeMap")
         
         // 模块初始化：尝试从本地缓存恢复隐私同意状态
         OnCreate {
-            // 先确保隐私信息展示状态
-            MAMapView.updatePrivacyShow(AMapPrivacyShowStatus.didShow, privacyInfo: AMapPrivacyInfoStatus.didContain)
 
-            // 从 UserDefaults 恢复上次的同意状态（默认 false）
-            let saved = UserDefaults.standard.bool(forKey: ExpoGaodeMapModule.privacyDefaultsKey)
-            ExpoGaodeMapModule.privacyAgreed = saved
-            if saved {
-                // 同步到 SDK
-                MAMapView.updatePrivacyAgree(AMapPrivacyAgreeStatus.didAgree)
-                print("🔁 ExpoGaodeMap: 已从缓存恢复隐私同意状态: true")
-                
-                // 🚀 自动启动预加载（延迟2秒，避免影响启动速度）
-                DispatchQueue.main.asyncAfter(deadline: .now() + 2.0) {
-                    print("🚀 ExpoGaodeMap: 自动启动地图预加载")
-                    MapPreloadManager.shared.startPreload(poolSize: 1)
-                }
-            } else {
-                print("ℹ️ ExpoGaodeMap: 未发现已同意记录，等待用户同意后再使用 SDK")
-            }
+             // 1. 告知 SDK：隐私协议已展示且包含隐私内容
+            MAMapView.updatePrivacyShow(
+                AMapPrivacyShowStatus.didShow,
+                privacyInfo: AMapPrivacyInfoStatus.didContain
+            )
+
+            // 2. 告知 SDK：用户已同意隐私协议（关键）
+            MAMapView.updatePrivacyAgree(AMapPrivacyAgreeStatus.didAgree)
+
+            print("✅ ExpoGaodeMap: 原生侧已默认同意隐私协议")
+
+             // 3. 自动设置 API Key（Info.plist）
+            self.trySetupApiKeyFromPlist()
+
+            // 4. 自动启动预加载（可选）
+            self.tryStartPreload(delay: 2.0, poolSize: 1)
         }
         
-        // ==================== 隐私合规管理 ====================
-        
+
         /**
-         * 更新隐私合规状态
-         * 必须在用户同意隐私协议后调用
+         * 更新隐私协议状态
+         * 不再需要主动调用，下个版本删除
          */
         Function("updatePrivacyCompliance") { (hasAgreed: Bool) in
-            // 更新内存状态
-            ExpoGaodeMapModule.privacyAgreed = hasAgreed
-            // 持久化到本地，供下次启动自动恢复
-            UserDefaults.standard.set(hasAgreed, forKey: ExpoGaodeMapModule.privacyDefaultsKey)
-
-            if hasAgreed {
-                // 同步到 SDK
-                MAMapView.updatePrivacyAgree(AMapPrivacyAgreeStatus.didAgree)
-                print("✅ ExpoGaodeMap: 用户已同意隐私协议，可以使用 SDK（状态已持久化）")
-                
-                // 在用户同意后，如果尚未设置 API Key，则尝试从 Info.plist 读取并设置
-                if AMapServices.shared().apiKey == nil || AMapServices.shared().apiKey?.isEmpty == true {
-                    if let plistKey = Bundle.main.infoDictionary?["AMapApiKey"] as? String, !plistKey.isEmpty {
-                        AMapServices.shared().apiKey = plistKey
-                        AMapServices.shared().enableHTTPS = true
-                        print("✅ ExpoGaodeMap: 从 Info.plist 读取并设置 AMapApiKey 成功")
-                    } else {
-                        print("⚠️ ExpoGaodeMap: Info.plist 未找到 AMapApiKey，后续需通过 initSDK 提供 iosKey")
-                    }
-                }
-                
-                // 🚀 用户首次同意后，立即启动预加载
-                DispatchQueue.main.asyncAfter(deadline: .now() + 1.0) {
-                    let status = MapPreloadManager.shared.getStatus()
-                    let isPreloading = (status["isPreloading"] as? Bool) ?? false
-                    
-                    if !MapPreloadManager.shared.hasPreloadedMapView() && !isPreloading {
-                        print("🚀 ExpoGaodeMap: 用户同意隐私协议，自动启动预加载")
-                        MapPreloadManager.shared.startPreload(poolSize: 1)
-                    }
-                }
-            } else {
-                MAMapView.updatePrivacyAgree(AMapPrivacyAgreeStatus.notAgree)
-                print("⚠️ ExpoGaodeMap: 用户未同意隐私协议，SDK 功能将受限（状态已持久化）")
-            }
+            MAMapView.updatePrivacyShow(
+                AMapPrivacyShowStatus.didShow,
+                privacyInfo: AMapPrivacyInfoStatus.didContain
+            )
+            MAMapView.updatePrivacyAgree(AMapPrivacyAgreeStatus.didAgree)
+            
         }
-        
         // ==================== SDK 初始化 ====================
         
         /**
@@ -98,13 +103,6 @@ public class ExpoGaodeMapModule: Module {
          * @param config 配置字典,包含 iosKey
          */
         Function("initSDK") { (config: [String: String]) in
-            // 检查是否已同意隐私协议
-            if !ExpoGaodeMapModule.privacyAgreed {
-                print("⚠️ ExpoGaodeMap: 用户未同意隐私协议，无法初始化 SDK")
-
-                return
-            }
-            
             // 1) 优先使用传入的 iosKey；2) 否则回退读取 Info.plist 的 AMapApiKey
             let providedKey = config["iosKey"]?.trimmingCharacters(in: .whitespacesAndNewlines)
             var finalKey: String? = (providedKey?.isEmpty == false) ? providedKey : nil
@@ -145,11 +143,6 @@ public class ExpoGaodeMapModule: Module {
          * 开始连续定位
          */
         Function("start") {
-            // 检查隐私协议状态
-            if !ExpoGaodeMapModule.privacyAgreed {
-                print("⚠️ ExpoGaodeMap: 用户未同意隐私协议，无法开始定位")
-                return
-            }
             
             // 检查是否已设置 API Key
             if AMapServices.shared().apiKey == nil || AMapServices.shared().apiKey?.isEmpty == true {
@@ -179,11 +172,7 @@ public class ExpoGaodeMapModule: Module {
          * 返回位置信息和逆地理编码结果
          */
         AsyncFunction("getCurrentLocation") { (promise: Promise) in
-            // 检查隐私协议状态
-            if !ExpoGaodeMapModule.privacyAgreed {
-                promise.reject("PRIVACY_NOT_AGREED", "用户未同意隐私协议，无法获取位置")
-                return
-            }
+
             
             // 检查是否已设置 API Key
             if AMapServices.shared().apiKey == nil || AMapServices.shared().apiKey?.isEmpty == true {
@@ -402,6 +391,43 @@ public class ExpoGaodeMapModule: Module {
             }
         }
         
+        /**
+         * 请求后台位置权限（iOS）
+         * 注意：必须在前台权限已授予后才能请求
+         */
+        AsyncFunction("requestBackgroundLocationPermission") { (promise: Promise) in
+            let status = CLLocationManager.authorizationStatus()
+            
+            // 检查前台权限是否已授予
+            if status != .authorizedWhenInUse && status != .authorizedAlways {
+                promise.reject("FOREGROUND_PERMISSION_REQUIRED", "必须先授予前台位置权限才能请求后台位置权限")
+                return
+            }
+            
+            // iOS 上后台权限通过 Info.plist 配置 + 系统设置
+            // 这里返回当前状态
+            let hasBackground = status == .authorizedAlways
+            
+            promise.resolve([
+                "granted": hasBackground,
+                "backgroundLocation": hasBackground,
+                "status": self.getAuthorizationStatusString(status),
+                "message": hasBackground ? "已授予后台权限" : "需要在系统设置中手动授予'始终'权限"
+            ])
+        }
+        
+        /**
+         * 打开应用设置页面
+         * 引导用户手动授予权限
+         */
+        Function("openAppSettings") {
+            if let url = URL(string: UIApplication.openSettingsURLString) {
+                if UIApplication.shared.canOpenURL(url) {
+                    UIApplication.shared.open(url, options: [:], completionHandler: nil)
+                }
+            }
+        }
+        
         // ==================== 地图预加载 ====================
         
         /**
@@ -446,7 +472,7 @@ public class ExpoGaodeMapModule: Module {
         }
     }
     
-    // MARK: - 私有方法
+    // MARK: - 定位管理器
     
     /**
      * 获取或创建定位管理器实例