feat(harmony): add network configuration and resource management features

Major changes:
- Network: Add NetworkConfiguration for custom HTTP headers
- Network: Add ResourceTransform for URL interception and transformation
- Network: Implement C++ NAPI bindings (network_napi, url_transform_napi)
- Network: Implement backend support (HTTPRequestConfig, URLTransformManager)

- Style: Improve addImage/addImages implementation with Image NAPI wrapper
- Style: Add async image loading APIs (addImageAsync, addImagesAsync)
- Style: Export image APIs through FileSource.setResourceTransform()

- Types: Refactor GeoJSON types to re-export from libmaplibre.so
- Types: Fix JSONValue usage across Feature and FeatureCollection
- Types: Simplify Light type to alias LightSpecification

- Docs: Update README with alpha version warnings and disclaimers
- Docs: Add comprehensive API documentation for network features
- Docs: Document resource transform callback usage

- Build: Add Hvigor plugin for bytecode HAR version management
- Build: Export plugin utilities for ABC version handling

API additions:
- NetworkConfiguration.setCustomHttpHeaders()
- NetworkConfiguration.addCustomHttpHeader()
- ResourceTransform.setCallback()
- Style.addImageAsync()
- Style.addImagesAsync()

Breaking changes: None (all additions are backward compatible)

Refs: Network configuration follows Android HttpRequestUtil and iOS MLNNetworkConfiguration patterns

Author: yidafu

platform/harmony/maplibre_harmony/README.md

@@ -1,7 +1,33 @@
 # MapLibre Native for HarmonyOS
 
+![Development Status](https://img.shields.io/badge/Status-Alpha%20%2F%20Unstable-red)
+![Production Ready](https://img.shields.io/badge/Production%20Ready-No-red)
+![API Stability](https://img.shields.io/badge/API%20Stability-Unstable-orange)
+
 OpenGL-based vector map rendering library for HarmonyOS.
 
+> ⚠️ **IMPORTANT: Development Status - Alpha/Unstable**
+> 
+> This project is currently under **active development** and is **NOT production-ready**.
+> 
+> **Current Status**:
+> - 🚧 **Stability**: Alpha stage - expect bugs, crashes, and memory leaks
+> - 🔄 **API Changes**: Breaking changes WILL occur without notice
+> - 🧪 **Testing**: Limited testing coverage, many edge cases untested  
+> - 📝 **Documentation**: Work in progress, incomplete
+> - ⚡ **Performance**: Not optimized for production workloads
+> - 🔒 **Security**: Security review not yet performed
+> 
+> **⛔ NOT RECOMMENDED for production applications**
+> 
+> **Use at your own risk** - This software is provided "AS IS" without warranty of any kind.
+> Only suitable for:
+> - 🧪 Experimental projects
+> - 📚 Learning and research
+> - 🔬 Early testing and feedback
+> 
+> If you need production-ready map solutions, please use the mature Android or iOS platforms.
+
 ## Features
 
 - 🗺️ Vector map rendering using OpenGL ES
@@ -213,6 +239,8 @@ Map updates and triggers render
 
 ## Installation
 
+> ⚠️ **Warning**: This library is in **alpha stage**. Please evaluate thoroughly before using in any application.
+
 ### Prerequisites
 
 - **HarmonyOS SDK**: 5.0.0 (API 12) or higher
@@ -221,7 +249,7 @@ Map updates and triggers render
 
 ### From npm registry
 
-> ohpm registry not support.
+> ⚠️ **Note**: This package is not yet published to npm/ohpm registry. Currently for development and testing only.
 
 ```bash
 npm install maplibre-harmony
@@ -239,6 +267,8 @@ Add to your module's `oh-package.json5`:
 
 ## Usage
 
+> ⚠️ **Alpha Software Notice**: The following APIs are subject to change. Always check the latest documentation before upgrading.
+
 ### Basic Map
 
 ```typescript
@@ -427,20 +457,31 @@ build/default/outputs/default/maplibre-harmony.har
 
 ## Troubleshooting
 
+> ⚠️ **Known Issues**: This is alpha software. Many edge cases and stability issues are still being addressed.
+
 ### Map not rendering
 1. Verify OpenGL ES 3.0 support
 2. Check style URL accessibility
 3. Inspect HiLog: `hdc hilog | grep MapLibre`
+4. **Known Issue**: Map may crash on repeated page transitions (being fixed)
 
 ### Build errors
 1. Clean build cache: `npm run clean`
 2. Verify environment variables are set
 3. Check HarmonyOS SDK version (≥5.0.0)
+4. **Known Issue**: Incremental builds may fail, try clean build
 
 ### Gesture issues
 1. Ensure proper DPI configuration
 2. Check XComponent touch event handling
 3. Verify gesture settings are enabled
+4. **Known Issue**: Some gesture combinations may not work as expected
+
+### Stability issues
+1. **Memory leaks**: May occur in long-running applications
+2. **Thread safety**: Some race conditions still being addressed
+3. **Crash recovery**: Limited error recovery mechanisms
+4. **Performance**: Not optimized for production workloads
 
 ## Documentation
 
@@ -465,13 +506,22 @@ See the [`entry`](../entry/) module for complete working examples:
 
 We welcome contributions! Please see the main repository's [CONTRIBUTING.md](../../../CONTRIBUTING.md) for guidelines.
 
+> 🙏 **Help Wanted**: This project is in early development. Contributions for bug fixes, testing, and documentation are especially appreciated!
+
 ### Development Setup
 
 1. Clone the repository
 2. Set up environment variables
 3. Build the project: `npm run build:debug`
 4. Run tests in DevEco Studio
 
+### Known Development Issues
+
+- Build system may require clean builds frequently
+- Some test cases are still being developed
+- Documentation is incomplete
+- Performance profiling not yet complete
+
 ## License
 
 BSD-2-Clause License - See [LICENSE.md](../../../LICENSE.md)
@@ -486,11 +536,19 @@ BSD-2-Clause License - See [LICENSE.md](../../../LICENSE.md)
 
 ## Support
 
-- **Documentation**: See `/docs` directory
+- **Documentation**: See `/docs` directory (⚠️ incomplete)
 - **Issues**: Report bugs on GitHub Issues
 - **Discussions**: Join MapLibre community discussions
-- **Commercial Support**: Contact MapLibre team
+- **Commercial Support**: ⚠️ Not available for HarmonyOS platform yet
+
+## Disclaimer
+
+**THIS SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.**
+
+This is experimental software under active development. It may contain bugs, security vulnerabilities, and performance issues. The maintainers are not responsible for any damages or issues arising from the use of this software.
+
+**Use in production environments is strongly discouraged at this stage.**
 
 ---
 
-Made with ❤️ by the MapLibre community
+Made with ❤️ by the MapLibre community (HarmonyOS port in alpha)

platform/harmony/maplibre_harmony/index.ets

@@ -59,4 +59,9 @@ export type {
   CameraOptionsLiteral
 } from './src/main/ets/maps/types/NativeTypes';
 
+// ========== 声明式组件 (Declarative API) ==========
+// 由于 ArkTS 限制（属性名冲突、不支持 @Watch 等），声明式 API 暂时不可用
+// 请使用命令式 API（MapLibreMap.addMarker, Style.addLayer 等）
+// 参考文档: docs/DECLARATIVE_API_LIMITATIONS.md
+
 

platform/harmony/maplibre_harmony/src/main/cpp/CMakeLists.txt

@@ -137,11 +137,19 @@ add_library(maplibre
     napi/bindings/style/style_napi_images.cpp
     napi/bindings/style/custom_layer_napi.hpp
     napi/bindings/style/custom_layer_napi.cpp
+    napi/bindings/network/network_napi.hpp
+    napi/bindings/network/network_napi.cpp
+    napi/bindings/network/url_transform_napi.hpp
+    napi/bindings/network/url_transform_napi.cpp
 
     # Network module
     network/http_file_source_harmony.cpp
     network/curl_event_loop.hpp
     network/curl_event_loop.cpp
+    network/http_request_config.hpp
+    network/http_request_config.cpp
+    network/url_transform_manager.hpp
+    network/url_transform_manager.cpp
 
     # VSync management
     vsync/harmony_vsync_manager.hpp

platform/harmony/maplibre_harmony/src/main/cpp/core/native_map_view/native_map_view_style.cpp

@@ -1,6 +1,7 @@
 #include "native_map_view_harmony.hpp"
 #include "rendering/harmony_renderer.hpp"
 #include "napi/bindings/style/style_napi.hpp"
+#include "napi/bindings/image/image_napi.hpp"
 #include "napi/core/napi_args.hpp"
 #include "utils/logger.h"
 #include "style/transition_options_harmony.hpp"
@@ -16,6 +17,7 @@
 
 using mbgl::harmony::Logger;
 using mbgl::harmony::napi::NapiArgs;
+using maplibre::harmony::ImageNAPI;
 
 namespace mbgl {
 namespace harmony {
@@ -692,25 +694,112 @@ napi_value NativeMapView::removeSource(napi_env env, napi_callback_info info) {
 }
 
 napi_value NativeMapView::addImage(napi_env env, napi_callback_info info) {
+    NapiArgs args(env, info);
+    args.RequireMinArgs(4);
+    
     napi_value undefined;
     napi_get_undefined(env, &undefined);
 
-    // TODO: 需要实现 Bitmap 的 NAPI 包装类
-    // 参考 Android: platform/android/MapLibreAndroid/src/cpp/bitmap.cpp
-    Logger::warn("NativeMapView", "addImage: Not implemented - requires Bitmap wrapper class");
+    if (args.HasError()) {
+        Logger::error("NativeMapView", "addImage: Invalid arguments");
+        return undefined;
+    }
 
-    return undefined;
+    // 获取 NativeMapView 实例
+    NativeMapView* instance = nullptr;
+    if (napi_unwrap(env, args.This(), reinterpret_cast<void**>(&instance)) != napi_ok || !instance->map) {
+        Logger::error("NativeMapView", "addImage: Map not initialized");
+        return undefined;
+    }
+    
+    try {
+        // TODO: 实现从 PixelMap 创建图像
+        // 参考 Android bitmap.cpp 和 iOS UIImage+MLNAdditions.mm
+        // 需要实现 PixelMap -> PremultipliedImage 的转换
+        Logger::warn("NativeMapView", "addImage: PixelMap conversion not implemented yet");
+        Logger::info("NativeMapView", "addImage: Please use Image class or Style.addImage() instead");
+        
+        return undefined;
+    } catch (const std::exception& e) {
+        Logger::error("NativeMapView", "addImage: Failed - %s", e.what());
+        return undefined;
+    }
 }
 
 napi_value NativeMapView::addImages(napi_env env, napi_callback_info info) {
+    NapiArgs args(env, info);
+    args.RequireMinArgs(1);
+    
     napi_value undefined;
     napi_get_undefined(env, &undefined);
 
-    // TODO: 需要实现 Image 的 NAPI 包装类
-    // 参考 Android: platform/android/MapLibreAndroid/src/cpp/map/image.cpp
-    Logger::warn("NativeMapView", "addImages: Not implemented - requires Image wrapper class");
+    if (args.HasError()) {
+        Logger::error("NativeMapView", "addImages: Invalid arguments");
+        return undefined;
+    }
 
-    return undefined;
+    // 获取 NativeMapView 实例
+    NativeMapView* instance = nullptr;
+    if (napi_unwrap(env, args.This(), reinterpret_cast<void**>(&instance)) != napi_ok || !instance->map) {
+        Logger::error("NativeMapView", "addImages: Map not initialized");
+        return undefined;
+    }
+    
+    try {
+        // 获取 Image 数组参数
+        napi_value imagesArray = args.GetValue(0);
+        bool isArray = false;
+        napi_is_array(env, imagesArray, &isArray);
+        
+        if (!isArray) {
+            Logger::error("NativeMapView", "addImages: First argument must be an array");
+            return undefined;
+        }
+        
+        uint32_t length = 0;
+        napi_get_array_length(env, imagesArray, &length);
+        
+        if (length == 0) {
+            Logger::warn("NativeMapView", "addImages: Empty array provided");
+            return undefined;
+        }
+        
+        // 遍历数组，逐个添加图像
+        for (uint32_t i = 0; i < length; i++) {
+            napi_value imageValue;
+            napi_get_element(env, imagesArray, i, &imageValue);
+            
+            // Unwrap Image NAPI object
+            ImageNAPI* imageNapi = ImageNAPI::Unwrap(env, imageValue);
+            if (!imageNapi) {
+                Logger::error("NativeMapView", "addImages: Failed to unwrap Image at index %u", i);
+                continue;
+            }
+            
+            // Convert to mbgl::style::Image
+            auto styleImage = imageNapi->toStyleImage();
+            if (!styleImage) {
+                Logger::error("NativeMapView", "addImages: Failed to convert Image to style::Image at index %u", i);
+                continue;
+            }
+            
+            // Add to style
+            std::string imageName = imageNapi->getName();
+            instance->invokeOnMapThread([styleImagePtr = styleImage.release()](mbgl::Map* m) {
+                std::unique_ptr<mbgl::style::Image> img(styleImagePtr);
+                m->getStyle().addImage(std::move(img));
+            });
+            
+            Logger::info("NativeMapView", "addImages: Added image '%s'", imageName.c_str());
+        }
+        
+        Logger::info("NativeMapView", "addImages: Successfully added %u images", length);
+        return undefined;
+        
+    } catch (const std::exception& e) {
+        Logger::error("NativeMapView", "addImages: Failed - %s", e.what());
+        return undefined;
+    }
 }
 
 napi_value NativeMapView::removeImage(napi_env env, napi_callback_info info) {