@evnydd0sf/react-native-amap3d-fix 3.2.4-fix.1

package/lib/src/sdk.ts

@@ -0,0 +1,11 @@
+import { NativeModules } from "react-native";
+
+const { AMapSdk } = NativeModules;
+
+export function init(apiKey?: string) {
+  AMapSdk.initSDK(apiKey);
+}
+
+export function getVersion(): Promise<string> {
+  return AMapSdk.getVersion();
+}

package/lib/src/types.ts

@@ -0,0 +1,137 @@
+/**
+ * 点坐标
+ */
+export interface Point {
+  x: number;
+  y: number;
+}
+
+/**
+ * 地理坐标
+ */
+export interface LatLng {
+  /**
+   * 纬度
+   */
+  latitude: number;
+
+  /**
+   * 经度
+   */
+  longitude: number;
+}
+
+/**
+ * 地图标注点
+ */
+export interface MapPoi {
+  /**
+   * 标注点 ID
+   */
+  id: string;
+
+  /**
+   * 标注点名称
+   */
+  name: string;
+
+  /**
+   * 标注点坐标
+   */
+  position: LatLng;
+}
+
+/**
+ * 矩形坐标边界
+ */
+export interface LatLngBounds {
+  /**
+   * 西南坐标
+   */
+  southwest: LatLng;
+
+  /**
+   * 东北坐标
+   */
+  northeast: LatLng;
+}
+
+/**
+ * 地图状态
+ */
+export interface CameraPosition {
+  /**
+   * 中心坐标
+   */
+  target?: LatLng;
+
+  /**
+   * 缩放级别
+   */
+  zoom?: number;
+
+  /**
+   * 朝向、旋转角度
+   */
+  bearing?: number;
+
+  /**
+   * 倾斜角度
+   */
+  tilt?: number;
+}
+
+/**
+ * 定位
+ */
+export interface Location extends LatLng {
+  /**
+   * 精度
+   */
+  accuracy: number;
+
+  /**
+   * 朝向
+   */
+  heading: number;
+
+  /**
+   * 海拔
+   */
+  altitude: number;
+
+  /**
+   * 运动速度
+   */
+  speed: number;
+}
+
+/**
+ * 地图类型
+ */
+export enum MapType {
+  /**
+   * 标准地图
+   */
+  Standard,
+
+  /**
+   * 卫星地图
+   */
+  Satellite,
+
+  /**
+   * 夜间地图
+   */
+  Night,
+
+  /**
+   * 导航地图
+   */
+  Navi,
+
+  /**
+   * 公交地图
+   */
+  Bus,
+}

package/license

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 7c00 <i@7c00.cc>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@evnydd0sf/react-native-amap3d-fix",
+  "version": "3.2.4-fix.1",
+  "description": "react-native 高德地图组件，支持 Android + iOS (Fork with compilation fix)",
+  "author": "evnydd0sf <me@evnydd0sf.club>",
+  "license": "MIT",
+  "keywords": [
+    "react-native",
+    "amap",
+    "maps",
+    "mapview"
+  ],
+  "main": "lib/src",
+  "files": [
+    "lib/src",
+    "lib/android/src",
+    "lib/android/build.gradle",
+    "lib/ios",
+    "react-native.config.js",
+    "react-native-amap3d.podspec"
+  ],
+  "homepage": "https://github.com/evnydd0sf/react-native-amap3d",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/evnydd0sf/react-native-amap3d"
+  },
+  "original": {
+    "name": "react-native-amap3d",
+    "author": "7c00 <i@7c00.cc>",
+    "repository": "https://github.com/qiuxiang/react-native-amap3d"
+  },
+  "scripts": {
+    "start": "react-native start",
+    "android": "react-native run-android",
+    "release-android": "react-native run-android --variant=release",
+    "reload": "adb reverse tcp:8081 tcp:8081 && adb shell input text rr",
+    "ios": "react-native run-ios"
+  },
+  "dependencies": {
+    "supercluster": "^7.1.4"
+  },
+  "devDependencies": {
+    "@react-native-picker/picker": "^2.4.8",
+    "@react-navigation/native": "^6.1.3",
+    "@react-navigation/native-stack": "^6.9.9",
+    "@types/react-native": "^0.71.2",
+    "@types/supercluster": "^7.1.0",
+    "react": "18.2.0",
+    "react-native": "^0.71.2",
+    "react-native-safe-area-context": "^4.5.0",
+    "react-native-screens": "^3.19.0"
+  },
+  "prettier": {
+    "printWidth": 100
+  }
+}

package/react-native-amap3d.podspec

@@ -0,0 +1,20 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "react-native-amap3d"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => "10.0" }
+  s.source       = { :git => "https://github.com/evnydd0sf/react-native-amap3d.git", :tag => "#{s.version}" }
+
+  s.source_files = "lib/ios/**/*.{h,m,mm,swift}"
+
+  s.dependency "React-Core"
+  s.dependency 'AMap3DMap', "10.0.1000"
+end

package/react-native.config.js

@@ -0,0 +1,20 @@
+module.exports = {
+  dependency: {
+    platforms: {
+      ios: { project: "lib/ios/react-native-amap3d.podspec" },
+      android: { sourceDir: "lib/android" },
+    },
+  },
+  dependencies: {
+    "react-native-amap3d": {
+      root: __dirname,
+      platforms: {
+        android: {
+          sourceDir: __dirname + "/lib/android",
+          packageImportPath: "import qiuxiang.amap3d.AMap3DPackage;",
+          packageInstance: "new AMap3DPackage()",
+        },
+      },
+    },
+  },
+};

package/readme.md

@@ -0,0 +1,186 @@
+# react-native-amap3d [![][version-badge]][npm] [![](https://github.com/evnydd0sf/react-native-amap3d/actions/workflows/build.yml/badge.svg)](https://github.com/evnydd0sf/react-native-amap3d/actions/workflows/build.yml)
+
+> 这是 [react-native-amap3d](https://github.com/qiuxiang/react-native-amap3d) 的 fork 版本，仅为 react-native-amap3d 修复 Xcode 编译问题而创建。
+
+## 修复内容
+
+- **修复了 iOS 编译时的链接错误问题**
+  - **问题描述**：在正式编译时出现 `ld: pointer not aligned in '_dbl_lnds_data_TileDataRespMsg_fields'` 错误
+  - **根本原因**：AMap3DMap SDK 版本兼容性问题，原 podspec 中的版本依赖导致链接器错误
+  - **解决方案**：将 `react-native-amap3d.podspec` 中的 AMap3DMap 依赖版本固定为 `10.0.1000`
+  - **测试状态**：✅ 开发调试正常 ✅ 正式编译通过
+
+## 功能
+
+- 地图模式切换（常规、卫星、导航、夜间）
+- 3D 建筑、路况、室内地图
+- 内置地图控件的显示隐藏（指南针、比例尺、定位按钮、缩放按钮）
+- 手势交互控制（平移、缩放、旋转、倾斜）
+- 中心坐标、缩放级别、倾斜度的设置，支持动画过渡
+- 地图事件（onPress、onLongPress、onLocation、onCameraMove、onCameraIdle 等）
+- 地图标记（Marker）
+- 折线绘制（Polyline）
+- 多边形绘制（Polygon）
+- 圆形绘制（Circle）
+- 热力图（HeatMap）
+- 海量点（MultiPoint）
+- 点聚合（Cluster）
+
+## 接口文档
+
+<https://qiuxiang.github.io/react-native-amap3d/api/>
+
+## 安装
+
+```bash
+npm i @evnydd0sf/react-native-amap3d
+```
+
+### 添加高德 API Key
+
+首先你需要获取高德地图 API Key：
+
+- [Aandroid](http://lbs.amap.com/api/android-sdk/guide/create-project/get-key)
+- [iOS](https://lbs.amap.com/api/ios-sdk/guide/create-project/get-key)
+
+然后你需要在显示地图前调用接口设置 API key：
+
+```js
+import { AMapSdk } from "@evnydd0sf/react-native-amap3d";
+import { Platform } from "react-native";
+
+AMapSdk.init(
+  Platform.select({
+    android: "c52c7169e6df23490e3114330098aaac",
+    ios: "186d3464209b74effa4d8391f441f14d",
+  })
+);
+```
+
+## 用法
+
+### 显示地图
+
+```jsx
+import { MapView, MapType } from "@evnydd0sf/react-native-amap3d";
+
+<MapView
+  mapType={MapType.Satellite}
+  initialCameraPosition={{
+    target: {
+      latitude: 39.91095,
+      longitude: 116.37296,
+    },
+    zoom: 8,
+  }}
+/>;
+```
+
+<img src=<https://user-images.githubusercontent.com/1709072/140698774-bdbfee64-d403-4e49-9a85-716d44783cfd.png> height=500> <img src=<https://user-images.githubusercontent.com/1709072/140849895-dada3f51-74c0-4685-b5d6-c1b69a4d06bb.PNG> height=500>
+
+### 监听地图事件
+
+```jsx
+import { MapView } from "@evnydd0sf/react-native-amap3d";
+
+<MapView
+  onLoad={() => console.log("onLoad")}
+  onPress={({ nativeEvent }) => console.log(nativeEvent)}
+  onCameraIdle={({ nativeEvent }) => console.log(nativeEvent)}
+/>;
+```
+
+<img src=<https://user-images.githubusercontent.com/1709072/140705501-9ed3e038-e52a-48c2-a98a-235c5c890549.png> height=500> <img src=<https://user-images.githubusercontent.com/1709072/140849894-3add3858-fc7f-47cd-9786-94aeef399ebc.PNG> height=500>
+
+### 添加标记
+
+其中 `icon` 支持 [ImageSource](https://reactnative.dev/docs/image#imagesource)。
+
+同时支持 `children` 作为标记图标。
+
+```jsx
+import { MapView, Marker } from "@evnydd0sf/react-native-amap3d";
+
+<MapView>
+  <Marker
+    position={{ latitude: 39.806901, longitude: 116.397972 }}
+    icon={require("../images/flag.png")}
+    onPress={() => alert("onPress")}
+  />
+  <Marker
+    position={{ latitude: 39.806901, longitude: 116.297972 }}
+    icon={{
+      uri: "https://reactnative.dev/img/pwa/manifest-icon-512.png",
+      width: 64,
+      height: 64,
+    }}
+  />
+  <Marker position={{ latitude: 39.906901, longitude: 116.397972 }}>
+    <Text
+      style={{
+        color: "#fff",
+        backgroundColor: "#009688",
+        alignItems: "center",
+        borderRadius: 5,
+        padding: 5,
+      }}
+    >
+      {new Date().toLocaleString()}
+    </Text>
+  </Marker>
+</MapView>;
+```
+
+<img src=<https://user-images.githubusercontent.com/1709072/140707579-4abe070a-3fc1-481d-8a2e-91ac2ad8bdc7.png> height=500> <img src=<https://user-images.githubusercontent.com/1709072/140849886-7eb9322b-8fa8-4049-a7b0-3eb36d006992.PNG> height=500>
+
+### 点聚合
+
+Marker 数量过多（尤其是使用自定义 View 的情况下）会导致性能问题，而且显示过于密集，这时候可以用点聚合改善。
+
+```jsx
+import { Cluster, MapView, Marker } from "@evnydd0sf/react-native-amap3d";
+
+const markers = Array(1000)
+  .fill(0)
+  .map((_, i) => ({
+    position: { latitude: 39.5 + Math.random(), longitude: 116 + Math.random() },
+    properties: { key: `Marker${i}` },
+  }));
+
+<MapView
+  ref={(ref) => (this.mapView = ref)}
+  onLoad={() => this.mapView?.moveCamera({ zoom: 8 }, 100)}
+  onCameraIdle={({ nativeEvent }) => {
+    this.status = nativeEvent;
+    this.cluster?.update(nativeEvent);
+  }}
+>
+  <Cluster
+    ref={(ref) => (this.cluster = ref)}
+    points={markers}
+    renderMarker={(item) => (
+      <Marker
+        key={item.properties.key}
+        icon={require("../images/flag.png")}
+        position={item.position}
+      />
+    )}
+  />
+</MapView>;
+```
+
+<img src=<https://user-images.githubusercontent.com/1709072/140710764-40f767cd-74fd-47ca-8310-897bbf58fbbd.png> height=500> <img src=<https://user-images.githubusercontent.com/1709072/140849888-6b6609c1-2e55-41c2-bdc3-f9d3fcc7a112.PNG> height=500>
+
+<img src=<https://user-images.githubusercontent.com/1709072/140710758-63e81ade-2635-4412-a5fa-b6948605fe75.png> height=500> <img src=<https://user-images.githubusercontent.com/1709072/140849880-9eb7609d-55a7-43be-8b6a-bac725fb0a82.PNG> height=500>
+
+### 更多示例
+
+参考 [example](https://github.com/evnydd0sf/react-native-amap3d/tree/master/example-app)。
+
+## 常见问题
+
+- 尽量使用真实设备进行测试，在模拟器可能存在一些问题（常见的是 Android 模拟器因为缺少 GPU 加速而导致闪退）。
+- onLocation 没有返回定位数据通常是因为 key 不正确，或没有申请 PermissionsAndroid.PERMISSIONS.ACCESS_FINE_LOCATION 权限
+
+[npm]: https://www.npmjs.com/package/react-native-amap3d
+[version-badge]: https://img.shields.io/npm/v/react-native-amap3d.svg