capacitor-baidu-location 0.0.1

package/CapacitorBaiduLocation.podspec

@@ -0,0 +1,23 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name = 'CapacitorBaiduLocation'
+  s.version = package['version']
+  s.summary = package['description']
+  s.license = package['license']
+  s.homepage = package['repository']['url']
+  s.author = package['author']
+  s.source = { :git => package['repository']['url'], :tag => s.version.to_s }
+  s.source_files = 'ios/Sources/**/*.{swift,h,m,c,cc,mm,cpp}'
+  s.ios.deployment_target = '14.0'
+  s.dependency 'Capacitor'
+  s.swift_version = '5.1'
+  
+  # 百度地图定位SDK依赖
+  s.vendored_frameworks = 'ios/Frameworks/BMKLocationKit.xcframework'
+  s.frameworks = 'CoreLocation', 'UIKit', 'Foundation', 'CoreTelephony', 'SystemConfiguration'
+  s.libraries = 'z', 'stdc++', 'sqlite3'
+  s.weak_frameworks = 'CoreMotion'
+end

package/Package.swift

@@ -0,0 +1,44 @@
+// swift-tools-version: 5.9
+import PackageDescription
+
+let package = Package(
+    name: "CapacitorBaiduLocation",
+    platforms: [.iOS(.v14)],
+    products: [
+        .library(
+            name: "CapacitorBaiduLocation",
+            targets: ["CPBaiduLocationPlugin"])
+    ],
+    dependencies: [
+        .package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", from: "7.0.0")
+    ],
+    targets: [
+        .binaryTarget(
+            name: "BMKLocationKit",
+            path: "ios/Frameworks/BMKLocationKit.xcframework"
+        ),
+        .target(
+            name: "CPBaiduLocationPlugin",
+            dependencies: [
+                .product(name: "Capacitor", package: "capacitor-swift-pm"),
+                .product(name: "Cordova", package: "capacitor-swift-pm"),
+                .target(name: "BMKLocationKit")
+            ],
+            path: "ios/Sources/CPBaiduLocationPlugin",
+            linkerSettings: [
+                    .linkedFramework("CoreTelephony"),
+                    .linkedFramework("CoreLocation"),
+                    .linkedFramework("SystemConfiguration"),
+                    .linkedFramework("Security"),
+                    .linkedFramework("CFNetwork"),
+                    .linkedFramework("CoreMotion"),
+                    .linkedFramework("AdSupport"),
+                    .linkedLibrary("sqlite3"),
+                    .linkedLibrary("c++")
+                ]),
+        .testTarget(
+            name: "CPBaiduLocationPluginTests",
+            dependencies: ["CPBaiduLocationPlugin"],
+            path: "ios/Tests/CPBaiduLocationPluginTests")
+    ]
+)

package/README.md

@@ -0,0 +1,376 @@
+# Capacitor Baidu Location Plugin
+
+一个支持 Capacitor 7 的百度地图定位插件，提供全面的定位功能，包括单次定位、权限管理、API Key 设置等。
+
+## 功能特性
+
+- ✅ 支持单次定位
+- ✅ 支持配置是否获取地址信息
+- ✅ 支持配置是否获取位置描述
+- ✅ 支持动态设置 API Key
+- ✅ 支持定位权限检查和请求
+- ✅ 支持坐标类型设置和获取
+- ✅ 支持 AK 验证状态检查
+- ✅ 基于 Capacitor 7
+
+## 安装
+
+```bash
+npm install capacitor-baidu-location
+npx cap sync
+```
+
+## 开发依赖
+
+### Android 开发依赖
+- Java版本 : 21
+- Kotlin版本 : 1.9.25
+- Gradle版本 : 8.7.2
+- gradle wrapper : 8.11.1
+- 第三方库 : OkHttp3 3.14.9
+
+### iOS 开发依赖
+- Xcode 16 +
+- Swift 5.9 +
+- iOS 14 +
+
+### Capacitor
+- TypeScript 5.1+
+- Capacitor 7.+
+- NodeJS 20+
+
+## 配置
+
+### 配置文件设置（推荐）
+
+插件支持读取配置，这是推荐的配置方式，便于集中管理和构建时配置。
+
+**capacitor.config.ts**
+```typescript
+import { CapacitorConfig } from '@capacitor/cli';
+
+const config: CapacitorConfig = {
+  appId: 'com.example.app',
+  appName: 'Example App',
+  webDir: 'dist',
+  plugins: {
+    CPBaiduLocation: {
+      iOSAK: 'your-ios-api-key',
+      androidAK: 'your-android-api-key',
+    }
+  }
+};
+
+export default config;
+```
+
+### Android 配置
+
+1. **API Key 配置**
+   - 百度地图 API Key 可以通过三种方式配置（优先级从高到低）：
+     - **方式一：动态设置**：在应用代码中调用 `setAK` 方法设置
+     - **方式二：配置文件设置**：在 `capacitor.config.ts` 中配置
+
+**注意：AndroidManifest.xml 需要配置占位值**：
+```xml
+<application>
+    <meta-data
+        android:name="com.baidu.lbsapi.API_KEY"
+        android:value="" />
+</application>
+```
+
+2. **权限配置**
+使用定位SDK，需在AndroidManifest.xml文件中Application标签中声明service组件，每个App拥有自己单独的定位service，代码如下：
+```xml
+<application>
+    <service android:name="com.baidu.location.f"
+        android:enabled="true"
+        android:process=":remote" />
+</application>
+```
+
+除添加service组件外，使用定位SDK还需添加如下权限：
+```xml
+<!-- 这个权限用于进行网络定位-->
+<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"></uses-permission>
+<!-- 这个权限用于访问系统接口提供的卫星定位信息-->
+<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"></uses-permission>
+<!-- 用于访问wifi网络信息，wifi信息会用于进行网络定位-->
+<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"></uses-permission>
+<!-- 获取运营商信息，用于支持提供运营商信息相关的接口-->
+<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"></uses-permission>
+<!-- 这个权限用于获取wifi的获取权限，wifi信息会用来进行网络定位-->
+<uses-permission android:name="android.permission.CHANGE_WIFI_STATE"></uses-permission>
+<!-- 写入扩展存储，向扩展卡写入数据，用于写入离线定位数据-->
+<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"></uses-permission>
+<!-- 访问网络，网络定位需要上网-->
+<uses-permission android:name="android.permission.INTERNET"></uses-permission>
+```
+
+### iOS 配置
+
+1. **API Key 配置**
+   - 百度地图 API Key 可以通过三种方式配置（优先级从高到低）：
+     - **方式一：动态设置**：在应用代码中调用 `setAK` 方法设置
+     - **方式二：配置文件设置**：在 `capacitor.config.ts` 中配置
+
+2. **权限配置**
+在 `Info.plist` 文件中添加以下权限描述：
+```xml
+<key>NSLocationWhenInUseUsageDescription</key>
+<string>需要获取您的位置信息</string>
+<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
+<string>需要获取您的位置信息</string>
+<key>NSLocationAlwaysUsageDescription</key>
+<string>需要获取您的位置信息</string>
+```
+
+### Web 配置
+
+Web 平台使用浏览器内置的地理定位 API，无需额外配置 API Key。
+
+## API
+
+### `setAK(options)`
+
+设置百度地图 API Key。可以覆盖配置文件中的设置，优先级最高。
+
+**参数**
+| 参数 | 类型 | 描述 |
+|------|------|------|
+| `ak` | `string` | 百度地图 API Key |
+
+**返回值**
+| 字段 | 类型 | 描述 |
+|------|------|------|
+| `success` | `boolean` | 设置是否成功 |
+| `errorMessage` | `string` | 错误信息（如果失败） |
+
+**说明**
+- 调用此方法会覆盖配置文件中的 AK 设置
+- 可以在应用运行时动态切换 AK
+
+### `checkAKValidation()`
+
+检查 API Key 验证状态。
+
+**返回值**
+| 字段 | 类型 | 描述 |
+|------|------|------|
+| `valid` | `boolean` | AK 是否有效 |
+| `errorMessage` | `string` | 错误信息（如果无效） |
+
+### `checkPermission()`
+
+检查定位权限状态。
+
+**返回值**
+| 字段 | 类型 | 描述 |
+|------|------|------|
+| `granted` | `boolean` | 权限是否已授予 |
+
+### `requestPermission()`
+
+请求定位权限。
+
+**返回值**
+| 字段 | 类型 | 描述 |
+|------|------|------|
+| `granted` | `boolean` | 权限是否已授予 |
+
+### `setCoordinateType(options)`
+
+设置坐标类型。
+
+**参数**
+| 参数 | 类型 | 描述 |
+|------|------|------|
+| `type` | `CoordinateType` | 坐标类型 |
+
+**返回值**
+| 字段 | 类型 | 描述 |
+|------|------|------|
+| `success` | `boolean` | 设置是否成功 |
+
+### `getCoordinateType()`
+
+获取当前坐标类型。
+
+**返回值**
+| 字段 | 类型 | 描述 |
+|------|------|------|
+| `type` | `CoordinateType` | 当前坐标类型 |
+
+### `getCurrentPosition(options?)`
+
+获取当前位置信息。
+
+**参数**
+| 参数 | 类型 | 描述 | 默认值 |
+|------|------|------|--------|
+| `needAddress` | `boolean` | 是否获取地址信息 | `false` |
+| `needLocationDescribe` | `boolean` | 是否获取位置描述 | `false` |
+
+**返回值**
+| 字段 | 类型 | 描述 |
+|------|------|------|
+| `latitude` | `number` | 纬度 |
+| `longitude` | `number` | 经度 |
+| `accuracy` | `number` | 定位精度（米） |
+| `address` | `string` | 完整地址 |
+| `country` | `string` | 国家 |
+| `province` | `string` | 省份 |
+| `city` | `string` | 城市 |
+| `district` | `string` | 区县 |
+| `street` | `string` | 街道 |
+| `adcode` | `string` | 行政区划代码 |
+| `town` | `string` | 乡镇 |
+| `locationDescribe` | `string` | 位置描述 |
+| `errorCode` | `number` | 错误码 |
+| `errorMessage` | `string` | 错误信息 |
+
+### `CoordinateType` 枚举
+
+| 枚举值 | 描述 |
+|--------|------|
+| `BD09LL` | 百度经纬度坐标 |
+| `BD09MC` | 百度墨卡托米制坐标 |
+| `GCJ02` | 国测局坐标 |
+| `WGS84` | WGS84坐标 |
+
+## 使用示例
+
+### 基本使用流程
+
+```typescript
+import { CPBaiduLocation, CoordinateType } from 'capacitor-baidu-location';
+
+// 1. 初始化 - 设置 API Key
+const initLocation = async () => {
+  const result = await CPBaiduLocation.setAK({
+    ak: '你的百度地图 API Key'
+  });
+  
+  if (result.success) {
+    console.log('API Key 设置成功');
+  } else {
+    console.error('API Key 设置失败:', result.errorMessage);
+  }
+};
+
+// 2. 检查并请求权限
+const checkAndRequestPermission = async () => {
+  const permissionStatus = await CPBaiduLocation.checkPermission();
+  
+  if (!permissionStatus.granted) {
+    const requestResult = await CPBaiduLocation.requestPermission();
+    if (!requestResult.granted) {
+      console.error('定位权限被拒绝');
+      return false;
+    }
+  }
+  
+  return true;
+};
+
+// 3. （可选）设置坐标类型
+const setCoordinateType = async () => {
+  await CPBaiduLocation.setCoordinateType({
+    type: CoordinateType.BD09LL
+  });
+};
+
+// 4. 获取当前位置
+const getLocation = async () => {
+  const hasPermission = await checkAndRequestPermission();
+  
+  if (!hasPermission) {
+    return;
+  }
+  
+  try {
+    const result = await CPBaiduLocation.getCurrentPosition({
+      needAddress: true,
+      needLocationDescribe: true
+    });
+    
+    if (result.errorCode) {
+      console.error('定位失败:', result.errorCode, result.errorMessage);
+    } else {
+      console.log('定位成功:', result);
+    }
+  } catch (error) {
+    console.error('定位异常:', error);
+  }
+};
+
+// 组合使用
+const fullExample = async () => {
+  await initLocation();
+  await setCoordinateType();
+  await getLocation();
+};
+```
+
+### 其他使用示例
+
+```typescript
+// 检查 AK 验证状态
+const checkAK = async () => {
+  const result = await CPBaiduLocation.checkAKValidation();
+  console.log('AK 验证状态:', result.valid ? '有效' : '无效');
+};
+
+// 获取当前坐标类型
+const getCurrentCoordinateType = async () => {
+  const result = await CPBaiduLocation.getCoordinateType();
+  console.log('当前坐标类型:', result.type);
+};
+
+
+```
+
+## 注意事项
+
+1. **API Key 申请**：
+   - 请确保在 [百度地图开放平台](https://lbs.baidu.com/) 申请了正确的 API Key
+   - Android、iOS、JSSDK 需要分别申请不同的 API Key
+   - 确保 API Key 已启用定位服务
+
+2. **权限管理**：
+   - 定位功能需要用户授权
+   - 请在适当的时机检查和请求权限
+
+3. **网络连接**：
+   - 获取地址信息和位置描述需要网络连接
+   - 基础定位功能可以在离线状态下使用
+
+## 错误码说明
+
+[Android 错误码](https://lbs.baidu.com/faq/api?title=android-locsdk/guide/addition-func/error-code)
+
+[iOS 错误码](https://lbs.baidu.com/faq/api?title=ios-locsdk/guide/addition-func/error-code)
+
+## 故障排除
+
+### API Key 设置失败
+**问题**：调用 `setAK` 方法返回失败
+**解决方案**：
+- 检查 API Key 是否正确
+- 检查网络连接是否正常
+- 确保 API Key 已在百度地图开放平台启用
+
+### 权限请求失败
+**问题**：用户拒绝了定位权限
+**解决方案**：
+- 提示用户定位权限的重要性
+- 引导用户在系统设置中手动开启权限
+- 优雅处理无权限的情况
+
+## 相关文档
+
+- [百度地图开放平台](https://lbs.baidu.com/)
+- [百度地图 Android 定位 SDK 文档](https://lbs.baidu.com/faq/api?title=android-locsdk/guide/get-location/latlng)
+- [百度地图 iOS 定位 SDK 文档](https://lbs.baidu.com/faq/api?title=ios-locsdk/guide/get-location/once)
+- [Capacitor 插件开发指南](https://capacitorjs.com/docs/plugins)

package/android/build.gradle

@@ -0,0 +1,71 @@
+ext {
+    junitVersion = project.hasProperty('junitVersion') ? rootProject.ext.junitVersion : '4.13.2'
+    androidxAppCompatVersion = project.hasProperty('androidxAppCompatVersion') ? rootProject.ext.androidxAppCompatVersion : '1.7.0'
+    androidxJunitVersion = project.hasProperty('androidxJunitVersion') ? rootProject.ext.androidxJunitVersion : '1.2.1'
+    androidxEspressoCoreVersion = project.hasProperty('androidxEspressoCoreVersion') ? rootProject.ext.androidxEspressoCoreVersion : '3.6.1'
+}
+
+buildscript {
+    repositories {
+        google()
+        mavenCentral()
+    }
+    dependencies {
+        classpath 'com.android.tools.build:gradle:8.7.2'
+        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:1.9.25"
+    }
+}
+
+apply plugin: 'com.android.library'
+apply plugin: 'org.jetbrains.kotlin.android'
+
+android {
+    namespace "com.hybrid.baidu.location"
+    compileSdk project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 35
+    defaultConfig {
+        minSdkVersion project.hasProperty('minSdkVersion') ? rootProject.ext.minSdkVersion : 23
+        targetSdkVersion project.hasProperty('targetSdkVersion') ? rootProject.ext.targetSdkVersion : 35
+        versionCode 1
+        versionName "1.0"
+        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+        // 指定支持的SO架构
+        ndk {
+            abiFilters 'arm64-v8a', 'x86_64'
+        }
+    }
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+        }
+    }
+    lintOptions {
+        abortOnError false
+    }
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_21
+        targetCompatibility JavaVersion.VERSION_21
+    }
+    kotlinOptions {
+        jvmTarget = "21"
+    }
+    sourceSets {
+        main {
+            jniLibs.srcDirs = ['libs']
+        }
+    }
+}
+
+dependencies {
+    // 本地AAR依赖（必须用implementation，确保传递到宿主）
+    implementation fileTree(dir: 'libs', include: ['*.jar'])
+    implementation project(':capacitor-android')
+    implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
+    testImplementation "junit:junit:$junitVersion"
+    androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
+    androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"
+    // 引入 OkHttp3 核心库
+    implementation 'com.squareup.okhttp3:okhttp:3.14.9'
+    // Kotlin标准库
+    implementation "org.jetbrains.kotlin:kotlin-stdlib:1.9.25"
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,32 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- 这个权限用于进行网络定位-->
+    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
+    <!-- 这个权限用于访问系统接口提供的卫星定位信息-->
+    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
+    <!-- 用于访问wifi网络信息，wifi信息会用于进行网络定位-->
+    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
+    <!-- 获取运营商信息，用于支持提供运营商信息相关的接口-->
+    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
+    <!-- 这个权限用于获取wifi的获取权限，wifi信息会用来进行网络定位-->
+    <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
+    <!-- 用于读取手机当前的状态-->
+    <uses-permission android:name="android.permission.READ_PHONE_STATE" />
+    <!-- 写入扩展存储，向扩展卡写入数据，用于写入离线定位数据-->
+    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
+    <!-- 访问网络，网络定位需要上网-->
+    <uses-permission android:name="android.permission.INTERNET" />
+    <!-- Android 10.0+ 定位需要的权限-->
+    <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
+
+    <application>
+        <!-- 百度地图AK配置 -->
+        <meta-data
+            android:name="com.baidu.lbsapi.API_KEY"
+            android:value="" />
+        <!-- 百度定位服务组件 -->
+        <service
+            android:name="com.baidu.location.f"
+            android:enabled="true"
+            android:process=":remote" />
+    </application>
+</manifest>