273 lines
9.9 KiB
Swift
273 lines
9.9 KiB
Swift
//
|
|
// LocationProvider.swift
|
|
// suixinkan
|
|
//
|
|
|
|
import CoreLocation
|
|
import Foundation
|
|
|
|
/// Core Location 管理器最小接口，便于模拟器定位实现注入测试替身。
|
|
@MainActor
|
|
protocol CoreLocationManaging: AnyObject {
|
|
var authorizationStatus: CLAuthorizationStatus { get }
|
|
var desiredAccuracy: CLLocationAccuracy { get set }
|
|
var delegate: CLLocationManagerDelegate? { get set }
|
|
|
|
/// 请求使用期间定位权限。
|
|
func requestWhenInUseAuthorization()
|
|
/// 请求一次当前位置。
|
|
func requestLocation()
|
|
}
|
|
|
|
extension CLLocationManager: CoreLocationManaging {}
|
|
|
|
/// Core Location 定位实现，供模拟器运行并支持依赖注入测试。
|
|
@MainActor
|
|
final class CoreLocationProvider: NSObject, LocationProviding, CLLocationManagerDelegate {
|
|
|
|
nonisolated static let shared = CoreLocationProvider()
|
|
|
|
private var appStore: AppStore = .shared
|
|
private var manager: any CoreLocationManaging = CLLocationManager()
|
|
private var geocoder: any LocationAddressGeocoding = LocationGeocoder.shared
|
|
private var permissionContinuation: CheckedContinuation<Void, Error>?
|
|
private var locationContinuation: CheckedContinuation<CLLocationCoordinate2D, Error>?
|
|
|
|
nonisolated override init() {
|
|
super.init()
|
|
}
|
|
|
|
/// 使用可控依赖创建 Core Location 定位服务。
|
|
init(
|
|
appStore: AppStore,
|
|
manager: any CoreLocationManaging,
|
|
geocoder: any LocationAddressGeocoding
|
|
) {
|
|
self.appStore = appStore
|
|
self.manager = manager
|
|
self.geocoder = geocoder
|
|
super.init()
|
|
manager.delegate = self
|
|
}
|
|
|
|
/// 请求坐标及逆地理编码地址。
|
|
func requestSnapshot(
|
|
desiredAccuracy: CLLocationAccuracy = kCLLocationAccuracyBest
|
|
) async throws -> HomeLocationSnapshot {
|
|
let coordinate = try await requestCoordinate(desiredAccuracy: desiredAccuracy)
|
|
let address = await geocoder.reverseGeocode(
|
|
latitude: coordinate.latitude,
|
|
longitude: coordinate.longitude
|
|
)
|
|
return HomeLocationSnapshot(
|
|
latitude: coordinate.latitude,
|
|
longitude: coordinate.longitude,
|
|
address: address
|
|
)
|
|
}
|
|
|
|
/// 请求一次当前位置坐标。
|
|
func requestCoordinate(
|
|
desiredAccuracy: CLLocationAccuracy
|
|
) async throws -> CLLocationCoordinate2D {
|
|
try requirePrivacyAgreement()
|
|
try await ensureLocationPermission()
|
|
guard locationContinuation == nil else {
|
|
throw LocationProviderError.locationFailed
|
|
}
|
|
|
|
manager.delegate = self
|
|
manager.desiredAccuracy = desiredAccuracy
|
|
return try await withCheckedThrowingContinuation { continuation in
|
|
locationContinuation = continuation
|
|
manager.requestLocation()
|
|
}
|
|
}
|
|
|
|
/// 使用系统服务将坐标解析为地址。
|
|
func reverseGeocode(latitude: Double, longitude: Double) async -> String {
|
|
guard appStore.session.privacyAgreementAccepted else { return "" }
|
|
return await geocoder.reverseGeocode(latitude: latitude, longitude: longitude)
|
|
}
|
|
|
|
/// 请求系统定位权限，等待用户完成首次授权。
|
|
func ensureLocationPermission() async throws {
|
|
manager.delegate = self
|
|
switch manager.authorizationStatus {
|
|
case .authorizedAlways, .authorizedWhenInUse:
|
|
return
|
|
case .denied, .restricted:
|
|
throw LocationProviderError.permissionDenied
|
|
case .notDetermined:
|
|
guard permissionContinuation == nil else {
|
|
throw LocationProviderError.locationFailed
|
|
}
|
|
try await withCheckedThrowingContinuation { continuation in
|
|
permissionContinuation = continuation
|
|
manager.requestWhenInUseAuthorization()
|
|
}
|
|
@unknown default:
|
|
throw LocationProviderError.permissionDenied
|
|
}
|
|
}
|
|
|
|
func locationManagerDidChangeAuthorization(_ manager: CLLocationManager) {
|
|
resolvePermission(status: self.manager.authorizationStatus)
|
|
}
|
|
|
|
func locationManager(_ manager: CLLocationManager, didUpdateLocations locations: [CLLocation]) {
|
|
guard let continuation = locationContinuation else { return }
|
|
locationContinuation = nil
|
|
guard let coordinate = locations.last?.coordinate,
|
|
CLLocationCoordinate2DIsValid(coordinate),
|
|
coordinate.latitude != 0 || coordinate.longitude != 0 else {
|
|
continuation.resume(throwing: LocationProviderError.locationFailed)
|
|
return
|
|
}
|
|
continuation.resume(returning: coordinate)
|
|
}
|
|
|
|
func locationManager(_ manager: CLLocationManager, didFailWithError error: Error) {
|
|
guard let continuation = locationContinuation else { return }
|
|
locationContinuation = nil
|
|
continuation.resume(throwing: LocationProviderError.locationFailed)
|
|
}
|
|
|
|
private func requirePrivacyAgreement() throws {
|
|
guard appStore.session.privacyAgreementAccepted else {
|
|
throw LocationProviderError.privacyNotAccepted
|
|
}
|
|
}
|
|
|
|
private func resolvePermission(status: CLAuthorizationStatus) {
|
|
guard let continuation = permissionContinuation else { return }
|
|
switch status {
|
|
case .authorizedAlways, .authorizedWhenInUse:
|
|
permissionContinuation = nil
|
|
continuation.resume()
|
|
case .denied, .restricted:
|
|
permissionContinuation = nil
|
|
continuation.resume(throwing: LocationProviderError.permissionDenied)
|
|
case .notDetermined:
|
|
break
|
|
@unknown default:
|
|
permissionContinuation = nil
|
|
continuation.resume(throwing: LocationProviderError.permissionDenied)
|
|
}
|
|
}
|
|
}
|
|
|
|
#if targetEnvironment(simulator)
|
|
|
|
/// 模拟器默认定位服务，使用 Core Location 与系统逆地理编码。
|
|
typealias LocationProvider = CoreLocationProvider
|
|
|
|
#else
|
|
|
|
/// 真机统一定位服务，封装高德 `AMapLocationManager`，对齐 Android `LocationProvider`。
|
|
@MainActor
|
|
final class LocationProvider: NSObject, LocationProviding {
|
|
|
|
nonisolated static let shared = LocationProvider()
|
|
|
|
private let permissionManager = CLLocationManager()
|
|
private let geocoder = LocationGeocoder.shared
|
|
|
|
nonisolated override init() {
|
|
super.init()
|
|
}
|
|
|
|
/// 请求坐标及高德逆地理编码地址。
|
|
func requestSnapshot(desiredAccuracy: CLLocationAccuracy = kCLLocationAccuracyBest) async throws -> HomeLocationSnapshot {
|
|
try AMapBootstrap.requireConfigured()
|
|
try await ensureLocationPermission()
|
|
|
|
let manager = makeLocationManager(
|
|
desiredAccuracy: desiredAccuracy,
|
|
locatingWithReGeocode: true
|
|
)
|
|
return try await withCheckedThrowingContinuation { continuation in
|
|
let started = manager.requestLocation(withReGeocode: true) { location, regeocode, error in
|
|
if let error {
|
|
continuation.resume(throwing: error)
|
|
return
|
|
}
|
|
guard let location else {
|
|
continuation.resume(throwing: LocationProviderError.locationFailed)
|
|
return
|
|
}
|
|
let address = regeocode?.formattedAddress ?? ""
|
|
continuation.resume(returning: HomeLocationSnapshot(
|
|
latitude: location.coordinate.latitude,
|
|
longitude: location.coordinate.longitude,
|
|
address: address
|
|
))
|
|
}
|
|
if !started {
|
|
continuation.resume(throwing: LocationProviderError.locationFailed)
|
|
}
|
|
}
|
|
}
|
|
|
|
/// 请求一次当前位置坐标。
|
|
func requestCoordinate(desiredAccuracy: CLLocationAccuracy) async throws -> CLLocationCoordinate2D {
|
|
try AMapBootstrap.requireConfigured()
|
|
try await ensureLocationPermission()
|
|
|
|
let manager = makeLocationManager(
|
|
desiredAccuracy: desiredAccuracy,
|
|
locatingWithReGeocode: false
|
|
)
|
|
return try await withCheckedThrowingContinuation { continuation in
|
|
let started = manager.requestLocation(withReGeocode: false) { location, _, error in
|
|
if let error {
|
|
continuation.resume(throwing: error)
|
|
return
|
|
}
|
|
guard let location else {
|
|
continuation.resume(throwing: LocationProviderError.locationFailed)
|
|
return
|
|
}
|
|
continuation.resume(returning: location.coordinate)
|
|
}
|
|
if !started {
|
|
continuation.resume(throwing: LocationProviderError.locationFailed)
|
|
}
|
|
}
|
|
}
|
|
|
|
/// 使用高德服务将坐标解析为地址。
|
|
func reverseGeocode(latitude: Double, longitude: Double) async -> String {
|
|
await geocoder.reverseGeocode(latitude: latitude, longitude: longitude)
|
|
}
|
|
|
|
/// 请求系统定位权限，首次弹窗后等待用户响应。
|
|
func ensureLocationPermission() async throws {
|
|
permissionManager.desiredAccuracy = kCLLocationAccuracyBest
|
|
let initialStatus = permissionManager.authorizationStatus
|
|
if initialStatus == .notDetermined {
|
|
permissionManager.requestWhenInUseAuthorization()
|
|
try await Task.sleep(nanoseconds: 500_000_000)
|
|
}
|
|
|
|
let status = permissionManager.authorizationStatus
|
|
guard status == .authorizedWhenInUse || status == .authorizedAlways else {
|
|
throw LocationProviderError.permissionDenied
|
|
}
|
|
}
|
|
|
|
private func makeLocationManager(
|
|
desiredAccuracy: CLLocationAccuracy,
|
|
locatingWithReGeocode: Bool
|
|
) -> AMapLocationManager {
|
|
let manager = AMapLocationManager()
|
|
manager.desiredAccuracy = desiredAccuracy
|
|
manager.locationTimeout = 30
|
|
manager.reGeocodeTimeout = 10
|
|
manager.locatingWithReGeocode = locatingWithReGeocode
|
|
return manager
|
|
}
|
|
}
|
|
|
|
#endif
|