expo-gaode-map 0.1.5 → 0.1.6

package/android/src/main/java/expo/modules/gaodemap/ExpoGaodeMapModule.kt

@@ -368,6 +368,10 @@ class ExpoGaodeMapModule : Module() {
       Prop<Int>("strokeColor") { view: PolylineView, color ->
         view.setStrokeColor(color)
       }
+      
+      Prop<String?>("texture") { view: PolylineView, texture ->
+        view.setTexture(texture)
+      }
     }
     
     // Polygon - 多边形

package/android/src/main/java/expo/modules/gaodemap/managers/OverlayManager.kt

@@ -1,9 +1,12 @@
 package expo.modules.gaodemap.managers
 
 import android.util.Log
+import android.graphics.BitmapFactory
 import com.amap.api.maps.AMap
 import com.amap.api.maps.model.LatLng
+import com.amap.api.maps.model.BitmapDescriptorFactory
 import expo.modules.gaodemap.utils.ColorParser
+import java.net.URL
 
 /**
  * 覆盖物管理器
@@ -151,9 +154,14 @@ class OverlayManager(private val aMap: AMap) {
     @Suppress("UNCHECKED_CAST")
     val points = props["points"] as? List<Map<String, Double>>
     val width = (props["width"] as? Number)?.toFloat() ?: 10f
-    val color = ColorParser.parseColor(props["color"])
+    val texture = props["texture"] as? String
+    val color = if (!texture.isNullOrEmpty()) {
+      android.graphics.Color.TRANSPARENT
+    } else {
+      ColorParser.parseColor(props["color"])
+    }
     
-    if (points != null && points.isNotEmpty()) {
+    if (points != null && points.size >= 2) {
       val latLngs = points.map { point ->
         val lat = point["latitude"] ?: 0.0
         val lng = point["longitude"] ?: 0.0
@@ -166,6 +174,30 @@ class OverlayManager(private val aMap: AMap) {
         .color(color)
       
       val polyline = aMap.addPolyline(options)
+      
+      // 处理纹理
+      if (!texture.isNullOrEmpty()) {
+        Thread {
+          try {
+            val bitmap = if (texture.startsWith("http://") || texture.startsWith("https://")) {
+              BitmapFactory.decodeStream(URL(texture).openStream())
+            } else if (texture.startsWith("file://")) {
+              BitmapFactory.decodeFile(texture.substring(7))
+            } else {
+              null
+            }
+            
+            bitmap?.let {
+              val descriptor = BitmapDescriptorFactory.fromBitmap(it)
+              polyline.setCustomTexture(descriptor)
+              Log.d(TAG, "✅ 纹理设置成功")
+            }
+          } catch (e: Exception) {
+            Log.e(TAG, "纹理加载失败: ${e.message}")
+          }
+        }.start()
+      }
+      
       polylines[id] = polyline
       Log.d(TAG, "✅ 折线创建成功")
     }

package/android/src/main/java/expo/modules/gaodemap/overlays/PolylineView.kt

@@ -3,12 +3,14 @@ package expo.modules.gaodemap.overlays
 import android.content.Context
 import android.graphics.Color
 import com.amap.api.maps.AMap
+import com.amap.api.maps.model.BitmapDescriptorFactory
 import com.amap.api.maps.model.LatLng
 import com.amap.api.maps.model.Polyline
 import com.amap.api.maps.model.PolylineOptions
 import expo.modules.kotlin.AppContext
 import expo.modules.kotlin.viewevent.EventDispatcher
 import expo.modules.kotlin.views.ExpoView
+import java.net.URL
 
 class PolylineView(context: Context, appContext: AppContext) : ExpoView(context, appContext) {
   
@@ -17,6 +19,7 @@ class PolylineView(context: Context, appContext: AppContext) : ExpoView(context,
   private var polyline: Polyline? = null
   private var aMap: AMap? = null
   private var points: List<LatLng> = emptyList()
+  private var textureUrl: String? = null
   
   /**
    * 设置地图实例
@@ -92,7 +95,6 @@ class PolylineView(context: Context, appContext: AppContext) : ExpoView(context,
    * 设置透明度
    */
   fun setOpacity(opacity: Float) {
-    // 通过修改颜色的 alpha 通道实现透明度
     polyline?.let { line ->
       val currentColor = line.color
       val alpha = (opacity * 255).toInt()
@@ -100,20 +102,69 @@ class PolylineView(context: Context, appContext: AppContext) : ExpoView(context,
     }
   }
   
+  /**
+   * 设置纹理图片
+   */
+  fun setTexture(url: String?) {
+    textureUrl = url
+    createOrUpdatePolyline()
+  }
+  
   /**
    * 创建或更新折线
    */
   private fun createOrUpdatePolyline() {
     aMap?.let { map ->
-      if (polyline == null && points.isNotEmpty()) {
+      // 移除旧折线
+      polyline?.remove()
+      polyline = null
+      
+      if (points.isNotEmpty()) {
         val options = PolylineOptions()
           .addAll(points)
           .width(10f)
           .color(Color.BLUE)
         
+        // 设置纹理
+        textureUrl?.let { url ->
+          try {
+            when {
+              url.startsWith("http://") || url.startsWith("https://") -> {
+                // 网络图片异步加载
+                Thread {
+                  try {
+                    val connection = URL(url).openConnection()
+                    val inputStream = connection.getInputStream()
+                    val bitmap = android.graphics.BitmapFactory.decodeStream(inputStream)
+                    inputStream.close()
+                    post {
+                      polyline?.setCustomTexture(BitmapDescriptorFactory.fromBitmap(bitmap))
+                    }
+                  } catch (e: Exception) {
+                    e.printStackTrace()
+                  }
+                }.start()
+              }
+              url.startsWith("file://") -> {
+                val path = url.substring(7)
+                val bitmap = android.graphics.BitmapFactory.decodeFile(path)
+                bitmap?.let { options.setCustomTexture(BitmapDescriptorFactory.fromBitmap(it)) }
+              }
+              else -> {
+                val resId = context.resources.getIdentifier(url, "drawable", context.packageName)
+                if (resId != 0) {
+                  val bitmap = android.graphics.BitmapFactory.decodeResource(context.resources, resId)
+                  options.setCustomTexture(BitmapDescriptorFactory.fromBitmap(bitmap))
+                }
+              }
+            }
+          } catch (e: Exception) {
+            e.printStackTrace()
+          }
+        }
+        
         polyline = map.addPolyline(options)
         
-        // 设置点击监听
         map.setOnPolylineClickListener { clickedPolyline ->
           if (clickedPolyline == polyline) {
             onPress(mapOf("id" to clickedPolyline.id))

package/build/components/overlays/Polyline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Polyline.d.ts","sourceRoot":"","sources":["../../../src/components/overlays/Polyline.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,KAAK,EAAE,aAAa,QA4BpD"}
+{"version":3,"file":"Polyline.d.ts","sourceRoot":"","sources":["../../../src/components/overlays/Polyline.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,KAAK,EAAE,aAAa,QAyBpD"}

package/build/components/overlays/Polyline.js

@@ -2,7 +2,7 @@
  * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
  * @Date         : 2025-11-13 15:01:30
  * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @LastEditTime : 2025-11-14 15:48:14
+ * @LastEditTime : 2025-11-15 01:08:27
  * @FilePath     : /expo-gaode-map/src/components/overlays/Polyline.tsx
  * @Description  : 地图折线组件 - 使用命令式 API
  *
@@ -29,25 +29,23 @@ import { MapContext } from '../../ExpoGaodeMapView';
  */
 export default function Polyline(props) {
     const mapRef = React.useContext(MapContext);
-    const polylineIdRef = React.useRef(`polyline_${Date.now()}_${Math.random()}`);
-    const isInitialMount = React.useRef(true);
+    const polylineIdRef = React.useRef(null);
     // 添加折线
     React.useEffect(() => {
-        const polylineId = polylineIdRef.current;
-        mapRef?.current?.addPolyline?.(polylineId, props);
+        const polylineId = `polyline_${Date.now()}_${Math.random()}`;
+        polylineIdRef.current = polylineId;
+        // 只传递必要的属性
+        const polylineProps = {
+            points: props.points,
+            width: props.width,
+            color: props.color,
+            ...(props.texture && { texture: props.texture }),
+        };
+        mapRef?.current?.addPolyline?.(polylineId, polylineProps);
         return () => {
             mapRef?.current?.removePolyline?.(polylineId);
         };
     }, []);
-    // 监听 Props 变化，更新折线（跳过初始渲染）
-    React.useEffect(() => {
-        if (isInitialMount.current) {
-            isInitialMount.current = false;
-            return;
-        }
-        const polylineId = polylineIdRef.current;
-        mapRef?.current?.updatePolyline?.(polylineId, props);
-    }, [props.points, props.width, props.color]);
     return null;
 }
 //# sourceMappingURL=Polyline.js.map

package/build/components/overlays/Polyline.js.map

@@ -1 +1 @@
-{"version":3,"file":"Polyline.js","sourceRoot":"","sources":["../../../src/components/overlays/Polyline.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGpD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,KAAoB;IACnD,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAS,YAAY,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACtF,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAE1C,OAAO;IACP,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC;QAEzC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAElD,OAAO,GAAG,EAAE;YACV,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,UAAU,CAAC,CAAC;QAChD,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,2BAA2B;IAC3B,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,IAAI,cAAc,CAAC,OAAO,EAAE,CAAC;YAC3B,cAAc,CAAC,OAAO,GAAG,KAAK,CAAC;YAC/B,OAAO;QACT,CAAC;QAED,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC;QACzC,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IACvD,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAE7C,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["/*\n * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com\n * @Date         : 2025-11-13 15:01:30\n * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com\n * @LastEditTime : 2025-11-14 15:48:14\n * @FilePath     : /expo-gaode-map/src/components/overlays/Polyline.tsx\n * @Description  : 地图折线组件 - 使用命令式 API\n * \n * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. \n */\n\nimport * as React from 'react';\nimport { MapContext } from '../../ExpoGaodeMapView';\nimport type { PolylineProps } from '../../types';\n\n/**\n * 地图折线组件\n * \n * @example\n * ```tsx\n * <MapView>\n *   <Polyline\n *     points={[\n *       { latitude: 39.9, longitude: 116.4 },\n *       { latitude: 39.91, longitude: 116.41 },\n *     ]}\n *     color=\"#FF0000\"\n *     width={5}\n *   />\n * </MapView>\n * ```\n */\nexport default function Polyline(props: PolylineProps) {\n  const mapRef = React.useContext(MapContext);\n  const polylineIdRef = React.useRef<string>(`polyline_${Date.now()}_${Math.random()}`);\n  const isInitialMount = React.useRef(true);\n\n  // 添加折线\n  React.useEffect(() => {\n    const polylineId = polylineIdRef.current;\n    \n    mapRef?.current?.addPolyline?.(polylineId, props);\n\n    return () => {\n      mapRef?.current?.removePolyline?.(polylineId);\n    };\n  }, []);\n\n  // 监听 Props 变化，更新折线（跳过初始渲染）\n  React.useEffect(() => {\n    if (isInitialMount.current) {\n      isInitialMount.current = false;\n      return;\n    }\n    \n    const polylineId = polylineIdRef.current;\n    mapRef?.current?.updatePolyline?.(polylineId, props);\n  }, [props.points, props.width, props.color]);\n\n  return null;\n}\n"]}
+{"version":3,"file":"Polyline.js","sourceRoot":"","sources":["../../../src/components/overlays/Polyline.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGpD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,KAAoB;IACnD,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAgB,IAAI,CAAC,CAAC;IAExD,OAAO;IACP,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,MAAM,UAAU,GAAG,YAAY,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;QAC7D,aAAa,CAAC,OAAO,GAAG,UAAU,CAAC;QAEnC,WAAW;QACX,MAAM,aAAa,GAAG;YACpB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;SACjD,CAAC;QAEF,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;QAE1D,OAAO,GAAG,EAAE;YACV,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,UAAU,CAAC,CAAC;QAChD,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["/*\n * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com\n * @Date         : 2025-11-13 15:01:30\n * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com\n * @LastEditTime : 2025-11-15 01:08:27\n * @FilePath     : /expo-gaode-map/src/components/overlays/Polyline.tsx\n * @Description  : 地图折线组件 - 使用命令式 API\n * \n * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. \n */\n\nimport * as React from 'react';\nimport { MapContext } from '../../ExpoGaodeMapView';\nimport type { PolylineProps } from '../../types';\n\n/**\n * 地图折线组件\n * \n * @example\n * ```tsx\n * <MapView>\n *   <Polyline\n *     points={[\n *       { latitude: 39.9, longitude: 116.4 },\n *       { latitude: 39.91, longitude: 116.41 },\n *     ]}\n *     color=\"#FF0000\"\n *     width={5}\n *   />\n * </MapView>\n * ```\n */\nexport default function Polyline(props: PolylineProps) {\n  const mapRef = React.useContext(MapContext);\n  const polylineIdRef = React.useRef<string | null>(null);\n\n  // 添加折线\n  React.useEffect(() => {\n    const polylineId = `polyline_${Date.now()}_${Math.random()}`;\n    polylineIdRef.current = polylineId;\n    \n    // 只传递必要的属性\n    const polylineProps = {\n      points: props.points,\n      width: props.width,\n      color: props.color,\n      ...(props.texture && { texture: props.texture }),\n    };\n    \n    mapRef?.current?.addPolyline?.(polylineId, polylineProps);\n\n    return () => {\n      mapRef?.current?.removePolyline?.(polylineId);\n    };\n  }, []);\n\n  return null;\n}\n"]}

package/build/types/overlays.types.d.ts

@@ -111,6 +111,11 @@ export interface PolylineProps {
      * 是否绘制虚线
      */
     dotted?: boolean;
+    /**
+     * 纹理图片
+     * 支持网络图片(http/https)、本地文件(file://)或资源名称
+     */
+    texture?: string;
     /**
      * 点击事件
      */

package/build/types/overlays.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"overlays.types.d.ts","sourceRoot":"","sources":["../../src/types/overlays.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAE3B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC;IAEf;;;OAGG;IACH,YAAY,CAAC,EAAE,KAAK,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAE3B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAErB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IAEzB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IAEpB;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;IAEnB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,WAAW,CAAC,EAAE,UAAU,CAAC;IAEzB;;OAEG;IACH,SAAS,CAAC,EAAE,UAAU,CAAC;IAEvB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,WAAW,CAAC,EAAE,UAAU,CAAC;IAEzB;;OAEG;IACH,SAAS,CAAC,EAAE,UAAU,CAAC;IAEvB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,IAAI,EAAE,MAAM,EAAE,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,MAAM;IAC5C;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAErB;;OAEG;IACH,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,KAAK,EAAE,cAAc,EAAE,CAAC;IAExB;;OAEG;IACH,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAE3B;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,WAAW,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,cAAc,CAAA;SAAE,CAAA;KAAE,KAAK,IAAI,CAAC;CACrF;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,UAAU,CAAC,EAAE,GAAG,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,YAAY,CAAC,EAAE,SAAS,CAAC;IAEzB;;OAEG;IACH,gBAAgB,CAAC,EAAE,SAAS,CAAC;IAE7B;;OAEG;IACH,MAAM,EAAE,YAAY,EAAE,CAAC;IAEvB;;OAEG;IACH,YAAY,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,KAAK,CAAC,SAAS,CAAC;IAEtD;;OAEG;IACH,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,KAAK,CAAC,SAAS,CAAC;IAE3D;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,CAAC;CAC3C"}
+{"version":3,"file":"overlays.types.d.ts","sourceRoot":"","sources":["../../src/types/overlays.types.ts"],"names":[],"mappings":"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"}

package/build/types/overlays.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"overlays.types.js","sourceRoot":"","sources":["../../src/types/overlays.types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * 高德地图覆盖物相关类型定义\n * 基于 Expo Modules API\n */\n\nimport type { ImageSourcePropType, ViewStyle } from 'react-native';\nimport type { ColorValue, LatLng, Point } from './common.types';\n\n/**\n * 标记点属性\n */\nexport interface MarkerProps {\n  /**\n   * 坐标\n   */\n  position: LatLng;\n\n  /**\n   * 图标\n   */\n  icon?: ImageSourcePropType;\n\n  /**\n   * 标题\n   */\n  title?: string;\n\n  /**\n   * 描述\n   */\n  snippet?: string;\n\n  /**\n   * 透明度 [0, 1]\n   * @platform android\n   */\n  opacity?: number;\n\n  /**\n   * 是否可拖拽\n   */\n  draggable?: boolean;\n\n  /**\n   * 是否平贴地图\n   * @platform android\n   */\n  flat?: boolean;\n\n  /**\n   * 层级\n   */\n  zIndex?: number;\n\n  /**\n   * 覆盖物锚点比例\n   * @platform android\n   */\n  anchor?: Point;\n\n  /**\n   * 覆盖物偏移位置\n   * @platform ios\n   */\n  centerOffset?: Point;\n\n  /**\n   * 自定义视图\n   */\n  children?: React.ReactNode;\n\n  /**\n   * 点击事件\n   */\n  onPress?: () => void;\n\n  /**\n   * 拖拽开始事件\n   */\n  onDragStart?: () => void;\n\n  /**\n   * 拖拽中事件\n   */\n  onDrag?: () => void;\n\n  /**\n   * 拖拽结束事件\n   */\n  onDragEnd?: (event: { nativeEvent: LatLng }) => void;\n}\n\n/**\n * 折线属性\n */\nexport interface PolylineProps {\n  /**\n   * 节点坐标数组\n   */\n  points: LatLng[];\n\n  /**\n   * 线宽\n   */\n  width?: number;\n\n  /**\n   * 线条颜色\n   */\n  color?: ColorValue;\n\n  /**\n   * 层级\n   */\n  zIndex?: number;\n\n  /**\n   * 分段颜色\n   */\n  colors?: ColorValue[];\n\n  /**\n   * 是否使用渐变色\n   */\n  gradient?: boolean;\n\n  /**\n   * 是否绘制大地线\n   */\n  geodesic?: boolean;\n\n  /**\n   * 是否绘制虚线\n   */\n  dotted?: boolean;\n\n  /**\n   * 点击事件\n   */\n  onPress?: () => void;\n}\n\n/**\n * 多边形属性\n */\nexport interface PolygonProps {\n  /**\n   * 节点坐标数组\n   */\n  points: LatLng[];\n\n  /**\n   * 边线宽度\n   */\n  strokeWidth?: number;\n\n  /**\n   * 边线颜色\n   */\n  strokeColor?: ColorValue;\n\n  /**\n   * 填充颜色\n   */\n  fillColor?: ColorValue;\n\n  /**\n   * 层级\n   */\n  zIndex?: number;\n\n  /**\n   * 点击事件\n   */\n  onPress?: () => void;\n}\n\n/**\n * 圆形属性\n */\nexport interface CircleProps {\n  /**\n   * 圆心坐标\n   */\n  center: LatLng;\n\n  /**\n   * 半径（米）\n   */\n  radius: number;\n\n  /**\n   * 边线宽度\n   */\n  strokeWidth?: number;\n\n  /**\n   * 边线颜色\n   */\n  strokeColor?: ColorValue;\n\n  /**\n   * 填充颜色\n   */\n  fillColor?: ColorValue;\n\n  /**\n   * 层级\n   */\n  zIndex?: number;\n\n  /**\n   * 点击事件\n   */\n  onPress?: () => void;\n}\n\n/**\n * 热力图属性\n */\nexport interface HeatMapProps {\n  /**\n   * 热力点数据\n   */\n  data: LatLng[];\n\n  /**\n   * 热力半径（米）\n   */\n  radius?: number;\n\n  /**\n   * 透明度 [0, 1]\n   */\n  opacity?: number;\n}\n\n/**\n * 海量点标记项\n */\nexport interface MultiPointItem extends LatLng {\n  /**\n   * 唯一标识\n   */\n  id?: string | number;\n\n  /**\n   * 自定义数据\n   */\n  data?: any;\n}\n\n/**\n * 海量点属性\n */\nexport interface MultiPointProps {\n  /**\n   * 点集合\n   */\n  items: MultiPointItem[];\n\n  /**\n   * 图标\n   */\n  icon?: ImageSourcePropType;\n\n  /**\n   * 点击事件\n   */\n  onPress?: (event: { nativeEvent: { index: number; item: MultiPointItem } }) => void;\n}\n\n/**\n * 聚合点参数\n */\nexport interface ClusterParams {\n  /**\n   * 唯一标识\n   */\n  id: number;\n\n  /**\n   * 包含的标记点数量\n   */\n  count: number;\n\n  /**\n   * 聚合点坐标\n   */\n  position: LatLng;\n}\n\n/**\n * 聚合点项\n */\nexport interface ClusterPoint {\n  /**\n   * 坐标\n   */\n  position: LatLng;\n\n  /**\n   * 自定义数据\n   */\n  properties?: any;\n}\n\n/**\n * 聚合图层属性\n */\nexport interface ClusterProps {\n  /**\n   * 聚合半径\n   */\n  radius?: number;\n\n  /**\n   * 聚合点样式\n   */\n  clusterStyle?: ViewStyle;\n\n  /**\n   * 聚合点文本样式\n   */\n  clusterTextStyle?: ViewStyle;\n\n  /**\n   * 坐标点列表\n   */\n  points: ClusterPoint[];\n\n  /**\n   * 渲染标记点\n   */\n  renderMarker: (item: ClusterPoint) => React.ReactNode;\n\n  /**\n   * 渲染聚合点\n   */\n  renderCluster?: (params: ClusterParams) => React.ReactNode;\n\n  /**\n   * 聚合点点击事件\n   */\n  onPress?: (params: ClusterParams) => void;\n}\n"]}
+{"version":3,"file":"overlays.types.js","sourceRoot":"","sources":["../../src/types/overlays.types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * 高德地图覆盖物相关类型定义\n * 基于 Expo Modules API\n */\n\nimport type { ImageSourcePropType, ViewStyle } from 'react-native';\nimport type { ColorValue, LatLng, Point } from './common.types';\n\n/**\n * 标记点属性\n */\nexport interface MarkerProps {\n  /**\n   * 坐标\n   */\n  position: LatLng;\n\n  /**\n   * 图标\n   */\n  icon?: ImageSourcePropType;\n\n  /**\n   * 标题\n   */\n  title?: string;\n\n  /**\n   * 描述\n   */\n  snippet?: string;\n\n  /**\n   * 透明度 [0, 1]\n   * @platform android\n   */\n  opacity?: number;\n\n  /**\n   * 是否可拖拽\n   */\n  draggable?: boolean;\n\n  /**\n   * 是否平贴地图\n   * @platform android\n   */\n  flat?: boolean;\n\n  /**\n   * 层级\n   */\n  zIndex?: number;\n\n  /**\n   * 覆盖物锚点比例\n   * @platform android\n   */\n  anchor?: Point;\n\n  /**\n   * 覆盖物偏移位置\n   * @platform ios\n   */\n  centerOffset?: Point;\n\n  /**\n   * 自定义视图\n   */\n  children?: React.ReactNode;\n\n  /**\n   * 点击事件\n   */\n  onPress?: () => void;\n\n  /**\n   * 拖拽开始事件\n   */\n  onDragStart?: () => void;\n\n  /**\n   * 拖拽中事件\n   */\n  onDrag?: () => void;\n\n  /**\n   * 拖拽结束事件\n   */\n  onDragEnd?: (event: { nativeEvent: LatLng }) => void;\n}\n\n/**\n * 折线属性\n */\nexport interface PolylineProps {\n  /**\n   * 节点坐标数组\n   */\n  points: LatLng[];\n\n  /**\n   * 线宽\n   */\n  width?: number;\n\n  /**\n   * 线条颜色\n   */\n  color?: ColorValue;\n\n  /**\n   * 层级\n   */\n  zIndex?: number;\n\n  /**\n   * 分段颜色\n   */\n  colors?: ColorValue[];\n\n  /**\n   * 是否使用渐变色\n   */\n  gradient?: boolean;\n\n  /**\n   * 是否绘制大地线\n   */\n  geodesic?: boolean;\n\n  /**\n   * 是否绘制虚线\n   */\n  dotted?: boolean;\n\n  /**\n   * 纹理图片\n   * 支持网络图片(http/https)、本地文件(file://)或资源名称\n   */\n  texture?: string;\n\n  /**\n   * 点击事件\n   */\n  onPress?: () => void;\n}\n\n/**\n * 多边形属性\n */\nexport interface PolygonProps {\n  /**\n   * 节点坐标数组\n   */\n  points: LatLng[];\n\n  /**\n   * 边线宽度\n   */\n  strokeWidth?: number;\n\n  /**\n   * 边线颜色\n   */\n  strokeColor?: ColorValue;\n\n  /**\n   * 填充颜色\n   */\n  fillColor?: ColorValue;\n\n  /**\n   * 层级\n   */\n  zIndex?: number;\n\n  /**\n   * 点击事件\n   */\n  onPress?: () => void;\n}\n\n/**\n * 圆形属性\n */\nexport interface CircleProps {\n  /**\n   * 圆心坐标\n   */\n  center: LatLng;\n\n  /**\n   * 半径（米）\n   */\n  radius: number;\n\n  /**\n   * 边线宽度\n   */\n  strokeWidth?: number;\n\n  /**\n   * 边线颜色\n   */\n  strokeColor?: ColorValue;\n\n  /**\n   * 填充颜色\n   */\n  fillColor?: ColorValue;\n\n  /**\n   * 层级\n   */\n  zIndex?: number;\n\n  /**\n   * 点击事件\n   */\n  onPress?: () => void;\n}\n\n/**\n * 热力图属性\n */\nexport interface HeatMapProps {\n  /**\n   * 热力点数据\n   */\n  data: LatLng[];\n\n  /**\n   * 热力半径（米）\n   */\n  radius?: number;\n\n  /**\n   * 透明度 [0, 1]\n   */\n  opacity?: number;\n}\n\n/**\n * 海量点标记项\n */\nexport interface MultiPointItem extends LatLng {\n  /**\n   * 唯一标识\n   */\n  id?: string | number;\n\n  /**\n   * 自定义数据\n   */\n  data?: any;\n}\n\n/**\n * 海量点属性\n */\nexport interface MultiPointProps {\n  /**\n   * 点集合\n   */\n  items: MultiPointItem[];\n\n  /**\n   * 图标\n   */\n  icon?: ImageSourcePropType;\n\n  /**\n   * 点击事件\n   */\n  onPress?: (event: { nativeEvent: { index: number; item: MultiPointItem } }) => void;\n}\n\n/**\n * 聚合点参数\n */\nexport interface ClusterParams {\n  /**\n   * 唯一标识\n   */\n  id: number;\n\n  /**\n   * 包含的标记点数量\n   */\n  count: number;\n\n  /**\n   * 聚合点坐标\n   */\n  position: LatLng;\n}\n\n/**\n * 聚合点项\n */\nexport interface ClusterPoint {\n  /**\n   * 坐标\n   */\n  position: LatLng;\n\n  /**\n   * 自定义数据\n   */\n  properties?: any;\n}\n\n/**\n * 聚合图层属性\n */\nexport interface ClusterProps {\n  /**\n   * 聚合半径\n   */\n  radius?: number;\n\n  /**\n   * 聚合点样式\n   */\n  clusterStyle?: ViewStyle;\n\n  /**\n   * 聚合点文本样式\n   */\n  clusterTextStyle?: ViewStyle;\n\n  /**\n   * 坐标点列表\n   */\n  points: ClusterPoint[];\n\n  /**\n   * 渲染标记点\n   */\n  renderMarker: (item: ClusterPoint) => React.ReactNode;\n\n  /**\n   * 渲染聚合点\n   */\n  renderCluster?: (params: ClusterParams) => React.ReactNode;\n\n  /**\n   * 聚合点点击事件\n   */\n  onPress?: (params: ClusterParams) => void;\n}\n"]}

package/docs/EXAMPLES.md

@@ -339,7 +339,7 @@ await mapRef.current?.removeMarker('marker1');
 
 ### Polyline (折线)
 
-**声明式用法:**
+**声明式用法 - 普通折线:**
 ```tsx
 <MapView style={{ flex: 1 }}>
   <Polyline
@@ -348,25 +348,86 @@ await mapRef.current?.removeMarker('marker1');
       { latitude: 39.95, longitude: 116.45 },
       { latitude: 40.0, longitude: 116.5 },
     ]}
-    strokeWidth={5}
-    strokeColor="#FF0000FF"
+    width={5}
+    color="#FFFF0000"
     onPress={() => console.log('点击折线')}
   />
 </MapView>
 ```
 
+**声明式用法 - 纹理折线:**
+```tsx
+import { Image } from 'react-native';
+
+const iconUri = Image.resolveAssetSource(require('./assets/arrow.png')).uri;
+
+<MapView style={{ flex: 1 }}>
+  <Polyline
+    points={[
+      { latitude: 39.9, longitude: 116.4 },
+      { latitude: 39.95, longitude: 116.45 },
+      { latitude: 40.0, longitude: 116.5 },
+    ]}
+    width={20}
+    color="#FFFF0000"
+    texture={iconUri}
+    onPress={() => console.log('点击纹理折线')}
+  />
+</MapView>
+```
+
 **命令式用法:**
 ```tsx
+// 普通折线
 await mapRef.current?.addPolyline('polyline1', {
   points: [
     { latitude: 39.9, longitude: 116.4 },
     { latitude: 40.0, longitude: 116.5 },
   ],
-  strokeWidth: 5,
-  strokeColor: 0xFFFF0000,
+  width: 5,
+  color: '#FFFF0000',
+});
+
+// 纹理折线
+await mapRef.current?.addPolyline('polyline2', {
+  points: [
+    { latitude: 39.9, longitude: 116.4 },
+    { latitude: 40.0, longitude: 116.5 },
+  ],
+  width: 20,
+  color: '#FFFF0000',
+  texture: iconUri,
+});
+
+// 分段纹理示例（使用多个 Polyline）
+const point1 = { latitude: 39.9, longitude: 116.4 };
+const point2 = { latitude: 39.95, longitude: 116.45 };
+const point3 = { latitude: 40.0, longitude: 116.5 };
+
+// 第一段：红色箭头
+await mapRef.current?.addPolyline('segment1', {
+  points: [point1, point2],
+  width: 20,
+  color: '#FFFF0000',
+  texture: redArrowUri,
+});
+
+// 第二段：蓝色箭头
+await mapRef.current?.addPolyline('segment2', {
+  points: [point2, point3],
+  width: 20,
+  color: '#FF0000FF',
+  texture: blueArrowUri,
 });
 ```
 
+> **注意**：
+> - 颜色格式使用 ARGB（`#AARRGGBB`），例如 `#FFFF0000` 表示不透明红色
+> - `texture` 支持网络图片（http/https）和本地文件（file://）
+> - 纹理图片会沿着折线方向平铺显示
+> - 建议纹理折线使用较大的 `width` 值（如 20）以获得更好的显示效果
+> - **分段纹理限制**：单个 Polyline 只能设置一个纹理。如需不同线段使用不同纹理，请创建多个 Polyline 组件
+
 ### Polygon (多边形)
 
 **声明式用法:**

package/ios/ExpoGaodeMapModule.swift

@@ -371,6 +371,10 @@ public class ExpoGaodeMapModule: Module {
             Prop("strokeColor") { (view: PolylineView, color: Int) in
                 view.setStrokeColor(color)
             }
+            
+            Prop("texture") { (view: PolylineView, url: String?) in
+                view.setTexture(url)
+            }
         }
         
         // Polygon - 多边形

package/ios/managers/OverlayManager.swift

@@ -67,26 +67,33 @@ class OverlayManager {
     // MARK: - Polyline
     
     func addPolyline(id: String, props: [String: Any]) {
+        print("📏 OverlayManager.addPolyline - id: \(id), props: \(props)")
+        
         guard let mapView = mapView,
-              let points = props["points"] as? [[String: Double]] else { return }
+              let points = props["points"] as? [[String: Double]] else {
+            print("❌ OverlayManager.addPolyline - mapView 或 points 为空")
+            return
+        }
+        
         var coordinates: [CLLocationCoordinate2D] = []
         for point in points {
             guard let lat = point["latitude"], let lng = point["longitude"] else { continue }
             coordinates.append(CLLocationCoordinate2D(latitude: lat, longitude: lng))
         }
-        guard !coordinates.isEmpty else { return }
+        guard coordinates.count >= 2 else {
+            print("❌ OverlayManager.addPolyline - 坐标点数量不足: \(coordinates.count)")
+            return
+        }
         
-        let polyline = MAMultiPolyline()
-        polyline.setPolylineWithCoordinates(&coordinates, count: coordinates.count)
+        let polyline = MAPolyline(coordinates: &coordinates, count: UInt(coordinates.count))!
         
+        // 先保存样式和 overlay，再添加到地图
         overlayStyles[id] = props
         overlays[id] = polyline
-        mapView.add(polyline)
         
-        // 强制刷新地图渲染
-        DispatchQueue.main.async {
-            mapView.setNeedsDisplay()
-        }
+        print("✅ OverlayManager.addPolyline - 准备添加到地图，id: \(id)")
+        mapView.add(polyline)
+        print("✅ OverlayManager.addPolyline - 已添加到地图")
     }
     
     func removePolyline(id: String) {
@@ -154,26 +161,43 @@ class OverlayManager {
             }
             
             return renderer
-        } else if let polyline = overlay as? MAMultiPolyline {
-            let renderer = MAMultiColoredPolylineRenderer(multiPolyline: polyline)
+        } else if let polyline = overlay as? MAPolyline {
+            let renderer = MAPolylineRenderer(polyline: polyline)!
             
-            if let color = style?["color"] {
-                renderer?.strokeColor = ColorParser.parseColor(color) ?? .red
-            } else if let strokeColor = style?["strokeColor"] {
-                renderer?.strokeColor = ColorParser.parseColor(strokeColor) ?? .red
+            // 设置线宽
+            if let width = style?["width"] as? Double {
+                renderer.lineWidth = CGFloat(width)
+            } else if let strokeWidth = style?["strokeWidth"] as? Double {
+                renderer.lineWidth = CGFloat(strokeWidth)
             } else {
-                renderer?.strokeColor = .red
+                renderer.lineWidth = 8
             }
             
-            if let width = style?["width"] as? Double {
-                renderer?.lineWidth = CGFloat(width)
-            } else if let strokeWidth = style?["strokeWidth"] as? Double {
-                renderer?.lineWidth = CGFloat(strokeWidth)
+            // 设置线条样式
+            renderer.lineJoinType = kMALineJoinRound
+            renderer.lineCapType = kMALineCapRound
+            
+            // 设置纹理或颜色
+            if let textureUrl = style?["texture"] as? String, !textureUrl.isEmpty {
+                loadPolylineTexture(url: textureUrl, renderer: renderer)
             } else {
-                renderer?.lineWidth = 5
+                if let color = style?["color"] {
+                    print("🎨 color 原始值: \(color), 类型: \(type(of: color))")
+                    let parsedColor = ColorParser.parseColor(color)
+                    print("🎨 解析后的颜色: \(String(describing: parsedColor))")
+                    renderer.strokeColor = parsedColor ?? .red
+                } else if let strokeColor = style?["strokeColor"] {
+                    print("🎨 strokeColor 原始值: \(strokeColor), 类型: \(type(of: strokeColor))")
+                    let parsedColor = ColorParser.parseColor(strokeColor)
+                    print("🎨 解析后的颜色: \(String(describing: parsedColor))")
+                    renderer.strokeColor = parsedColor ?? .red
+                } else {
+                    print("⚠️ 没有找到 color 或 strokeColor，使用默认红色")
+                    renderer.strokeColor = .red
+                }
             }
             
-            return renderer!
+            return renderer
         } else if let polygon = overlay as? MAPolygon {
             guard let renderer = MAPolygonRenderer(polygon: polygon) else {
                 return nil
@@ -195,6 +219,48 @@ class OverlayManager {
         return nil
     }
     
+    private func loadPolylineTexture(url: String, renderer: MAPolylineRenderer) {
+        if url.hasPrefix("http://") || url.hasPrefix("https://") {
+            guard let imageUrl = URL(string: url) else {
+                print("❌ OverlayManager: 无效的 URL: \(url)")
+                return
+            }
+            URLSession.shared.dataTask(with: imageUrl) { [weak self] data, _, error in
+                if let error = error {
+                    print("❌ OverlayManager: 下载图片失败: \(error)")
+                    return
+                }
+                guard let data = data, let image = UIImage(data: data) else {
+                    print("❌ OverlayManager: 无法创建图片")
+                    return
+                }
+                print("✅ OverlayManager: 图片下载成功，大小: \(image.size)")
+                DispatchQueue.main.async {
+                    self?.applyPolylineTexture(image: image, to: renderer)
+                }
+            }.resume()
+        } else if url.hasPrefix("file://") {
+            let path = String(url.dropFirst(7))
+            if let image = UIImage(contentsOfFile: path) {
+                print("✅ OverlayManager: 本地图片加载成功")
+                applyPolylineTexture(image: image, to: renderer)
+            } else {
+                print("❌ OverlayManager: 本地图片加载失败: \(path)")
+            }
+        } else {
+            if let image = UIImage(named: url) {
+                print("✅ OverlayManager: 资源图片加载成功")
+                applyPolylineTexture(image: image, to: renderer)
+            } else {
+                print("❌ OverlayManager: 资源图片加载失败: \(url)")
+            }
+        }
+    }
+    
+    private func applyPolylineTexture(image: UIImage, to renderer: MAPolylineRenderer) {
+        renderer.strokeImage = image
+    }
+    
     func clear() {
         guard let mapView = mapView else { return }
         for overlay in overlays.values {
@@ -207,4 +273,4 @@ class OverlayManager {
         overlayStyles.removeAll()
         annotations.removeAll()
     }
-}
+}

package/ios/overlays/PolylineView.swift

@@ -5,6 +5,7 @@ class PolylineView: ExpoView {
     var points: [[String: Double]] = []
     var strokeWidth: Float = 0
     var strokeColor: Any?
+    var textureUrl: String?
     
     private var mapView: MAMapView?
     var polyline: MAPolyline?
@@ -36,12 +37,67 @@ class PolylineView: ExpoView {
     func getRenderer() -> MAOverlayRenderer {
         if renderer == nil, let polyline = polyline {
             renderer = MAPolylineRenderer(polyline: polyline)
-            renderer?.strokeColor = ColorParser.parseColor(strokeColor) ?? UIColor.clear
             renderer?.lineWidth = CGFloat(strokeWidth)
+            
+            if let url = textureUrl {
+                print("🎨 PolylineView: 加载纹理 URL: \(url)")
+                loadTexture(url: url, renderer: renderer!)
+            } else {
+                renderer?.strokeColor = ColorParser.parseColor(strokeColor) ?? UIColor.clear
+            }
         }
         return renderer!
     }
     
+    private func loadTexture(url: String, renderer: MAPolylineRenderer) {
+        if url.hasPrefix("http://") || url.hasPrefix("https://") {
+            guard let imageUrl = URL(string: url) else {
+                print("❌ PolylineView: 无效的 URL: \(url)")
+                return
+            }
+            URLSession.shared.dataTask(with: imageUrl) { [weak self] data, _, error in
+                if let error = error {
+                    print("❌ PolylineView: 下载图片失败: \(error)")
+                    return
+                }
+                guard let data = data, let image = UIImage(data: data) else {
+                    print("❌ PolylineView: 无法创建图片")
+                    return
+                }
+                print("✅ PolylineView: 图片下载成功，大小: \(image.size)")
+                DispatchQueue.main.async {
+                    self?.applyTexture(image: image, to: renderer)
+                }
+            }.resume()
+        } else if url.hasPrefix("file://") {
+            let path = String(url.dropFirst(7))
+            if let image = UIImage(contentsOfFile: path) {
+                print("✅ PolylineView: 本地图片加载成功")
+                applyTexture(image: image, to: renderer)
+            } else {
+                print("❌ PolylineView: 本地图片加载失败: \(path)")
+            }
+        } else {
+            if let image = UIImage(named: url) {
+                print("✅ PolylineView: 资源图片加载成功")
+                applyTexture(image: image, to: renderer)
+            } else {
+                print("❌ PolylineView: 资源图片加载失败: \(url)")
+            }
+        }
+    }
+    
+    private func applyTexture(image: UIImage, to renderer: MAPolylineRenderer) {
+        let selector = NSSelectorFromString("loadStrokeTextureImage:")
+        if renderer.responds(to: selector) {
+            renderer.perform(selector, with: image)
+            print("✅ PolylineView: 纹理已应用")
+            mapView?.setNeedsDisplay()
+        } else {
+            print("❌ PolylineView: renderer 不支持 loadStrokeTextureImage 方法")
+        }
+    }
+    
     func setPoints(_ points: [[String: Double]]) {
         self.points = points
         renderer = nil
@@ -59,4 +115,10 @@ class PolylineView: ExpoView {
         renderer = nil
         updatePolyline()
     }
+    
+    func setTexture(_ url: String?) {
+        textureUrl = url
+        renderer = nil
+        updatePolyline()
+    }
 }

package/ios/{ColorParser.swift → utils/ColorParser.swift}

@@ -73,18 +73,19 @@ class ColorParser {
             hex = r + g + b + a
         }
         
-        // 处理 #RRGGBBAA 格式
+        // 处理 #AARRGGBB 或 #RRGGBBAA 格式
         if hex.count == 8 {
             let scanner = Scanner(string: hex)
             var hexNumber: UInt64 = 0
             
             if scanner.scanHexInt64(&hexNumber) {
-                let red = CGFloat((hexNumber & 0xff000000) >> 24) / 255
-                let green = CGFloat((hexNumber & 0x00ff0000) >> 16) / 255
-                let blue = CGFloat((hexNumber & 0x0000ff00) >> 8) / 255
-                alpha = CGFloat(hexNumber & 0x000000ff) / 255
+                // 尝试 ARGB 格式（Android 风格）
+                let alphaARGB = CGFloat((hexNumber & 0xff000000) >> 24) / 255
+                let redARGB = CGFloat((hexNumber & 0x00ff0000) >> 16) / 255
+                let greenARGB = CGFloat((hexNumber & 0x0000ff00) >> 8) / 255
+                let blueARGB = CGFloat(hexNumber & 0x000000ff) / 255
                 
-                return UIColor(red: red, green: green, blue: blue, alpha: alpha)
+                return UIColor(red: redARGB, green: greenARGB, blue: blueARGB, alpha: alphaARGB)
             }
         }
         
@@ -146,7 +147,7 @@ class ColorParser {
     }
 }
 
-// UIColor 扩展，支持从数字创建
+// UIColor 扩展，支持从数字创建（ARGB 格式）
 extension UIColor {
     convenience init(hex: Int) {
         let alpha = CGFloat((hex >> 24) & 0xFF) / 255.0
@@ -155,4 +156,9 @@ extension UIColor {
         let blue = CGFloat(hex & 0xFF) / 255.0
         self.init(red: red, green: green, blue: blue, alpha: alpha)
     }
+    
+    // 别名方法，与 hex 功能相同
+    convenience init(argb: Int) {
+        self.init(hex: argb)
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-gaode-map",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "一个功能完整的高德地图 React Native 组件库，基于 Expo Modules 开发，提供地图显示、定位、覆盖物等功能。",
   "main": "build/index.js",
   "types": "build/index.d.ts",

package/src/components/overlays/Polyline.tsx

@@ -2,7 +2,7 @@
  * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
  * @Date         : 2025-11-13 15:01:30
  * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @LastEditTime : 2025-11-14 15:48:14
+ * @LastEditTime : 2025-11-15 01:08:27
  * @FilePath     : /expo-gaode-map/src/components/overlays/Polyline.tsx
  * @Description  : 地图折线组件 - 使用命令式 API
  * 
@@ -32,30 +32,27 @@ import type { PolylineProps } from '../../types';
  */
 export default function Polyline(props: PolylineProps) {
   const mapRef = React.useContext(MapContext);
-  const polylineIdRef = React.useRef<string>(`polyline_${Date.now()}_${Math.random()}`);
-  const isInitialMount = React.useRef(true);
+  const polylineIdRef = React.useRef<string | null>(null);
 
   // 添加折线
   React.useEffect(() => {
-    const polylineId = polylineIdRef.current;
+    const polylineId = `polyline_${Date.now()}_${Math.random()}`;
+    polylineIdRef.current = polylineId;
     
-    mapRef?.current?.addPolyline?.(polylineId, props);
+    // 只传递必要的属性
+    const polylineProps = {
+      points: props.points,
+      width: props.width,
+      color: props.color,
+      ...(props.texture && { texture: props.texture }),
+    };
+    
+    mapRef?.current?.addPolyline?.(polylineId, polylineProps);
 
     return () => {
       mapRef?.current?.removePolyline?.(polylineId);
     };
   }, []);
 
-  // 监听 Props 变化，更新折线（跳过初始渲染）
-  React.useEffect(() => {
-    if (isInitialMount.current) {
-      isInitialMount.current = false;
-      return;
-    }
-    
-    const polylineId = polylineIdRef.current;
-    mapRef?.current?.updatePolyline?.(polylineId, props);
-  }, [props.points, props.width, props.color]);
-
   return null;
 }

package/src/types/overlays.types.ts

@@ -134,6 +134,12 @@ export interface PolylineProps {
    */
   dotted?: boolean;
 
+  /**
+   * 纹理图片
+   * 支持网络图片(http/https)、本地文件(file://)或资源名称
+   */
+  texture?: string;
+
   /**
    * 点击事件
    */

package/ios/UIColorExtension.swift

@@ -1,11 +0,0 @@
-import UIKit
-
-extension UIColor {
-    convenience init(argb: Int) {
-        let alpha = CGFloat((argb >> 24) & 0xFF) / 255.0
-        let red = CGFloat((argb >> 16) & 0xFF) / 255.0
-        let green = CGFloat((argb >> 8) & 0xFF) / 255.0
-        let blue = CGFloat(argb & 0xFF) / 255.0
-        self.init(red: red, green: green, blue: blue, alpha: alpha)
-    }
-}