@zhangdali1996/lr-map-viewer 0.0.6 → 0.0.8

package/README.md

@@ -48,6 +48,32 @@ public/
 
 如果客户项目的静态资源目录不是根路径，需要通过 `lr3dConfig.sdk` 自定义覆盖路径。
 
+如果客户项目把龙软静态资源统一挂在某个业务前缀下，也可以只传 `sdk.resourcePrefix`，让组件自动给默认的 `/editorapp` 和 `/resource` 路径补前缀。
+
+例如：
+
+```js
+const lr3dConfig = {
+  sdk: {
+    resourcePrefix: 'gkpt',
+  },
+}
+```
+
+会自动解析为：
+
+- `/gkpt/editorapp/editorapp.bundle.js`
+- `/gkpt/resource/js/three.min.js`
+- `/gkpt/resource/js/vue.2.6.11.js`
+- `/gkpt/resource/js/element_ui.js`
+- `/gkpt/resource/js/jquery-3.1.1.min.js`
+
+说明：
+
+- 不传 `sdk.resourcePrefix` 时，默认仍然使用 `/editorapp` 和 `/resource`
+- 支持传 `gkpt`、`/gkpt`、`gkpt/`、`/gkpt/`，最终都会归一化为 `/gkpt`
+- 如果你已经显式传了完整的 `sdk.scriptSrc` 或 `sdk.dependencies[].src`，则建议直接传最终路径
+
 ## 最小接入示例
 
 ### 三维示例
@@ -56,16 +82,12 @@ public/
 <script setup>
 import { LrMapViewer } from '@zhangdali1996/lr-map-viewer'
 
+const credentialKey = 'your_credential_key'
+
 const lr3dConfig = {
   // 是否在场景初始化成功后自动加载云 GIS 数据
   autoLoad: true,
   cloud: {
-    // 云 GIS 服务地址
-    server: 'https://your-cloud-gis-server/',
-    // 云 GIS 用户名
-    username: 'your_username',
-    // 云 GIS 密码
-    password: 'your_password',
     // 数据源 guid
     dsGuid: 'your_ds_guid',
     // 三维场景基点
@@ -88,7 +110,7 @@ const lr3dConfig = {
 
 <template>
   <div style="height: 100vh;">
-    <LrMapViewer :lr3d-config="lr3dConfig" />
+    <LrMapViewer :lr3d-config="lr3dConfig" :credential-key="credentialKey" />
   </div>
 </template>
 ```
@@ -99,6 +121,8 @@ const lr3dConfig = {
 <script setup>
 import { LrMapViewer } from '@zhangdali1996/lr-map-viewer'
 
+const credentialKey = 'your_credential_key'
+
 const map2dConfig = {
   behavior: {
     autoInitLayer: true,
@@ -107,18 +131,20 @@ const map2dConfig = {
   },
   options: {
     ygis_dsGuid: 'your_ds_guid',
-    ygis_url: 'https://your-cloud-gis-server/',
-    Url: 'https://your-map-server/',
     layerName: 'your_layer_name',
     layerCode: '',
-    token: 'your_token',
   },
 }
 </script>
 
 <template>
   <div style="height: 100vh;">
-    <LrMapViewer mode="2d" :modes="['2d']" :map2d-config="map2dConfig" />
+    <LrMapViewer
+      mode="2d"
+      :modes="['2d']"
+      :map2d-config="map2dConfig"
+      :credential-key="credentialKey"
+    />
   </div>
 </template>
 ```
@@ -131,22 +157,18 @@ import { ref } from 'vue'
 import { LrMapViewer } from '@zhangdali1996/lr-map-viewer'
 
 const activeMode = ref('2d')
+const credentialKey = 'your_credential_key'
+
 const map2dConfig = {
   options: {
     ygis_dsGuid: 'your_ds_guid',
-    ygis_url: 'https://your-cloud-gis-server/',
-    Url: 'https://your-map-server/',
     layerName: 'your_layer_name',
-    token: 'your_token',
   },
 }
 
 const lr3dConfig = {
   autoLoad: true,
   cloud: {
-    server: 'https://your-cloud-gis-server/',
-    username: 'your_username',
-    password: 'your_password',
     dsGuid: 'your_ds_guid',
     basePoint: {
       x: 37517614.46684,
@@ -165,6 +187,7 @@ const lr3dConfig = {
       :modes="['2d', '3d']"
       :map2d-config="map2dConfig"
       :lr3d-config="lr3dConfig"
+      :credential-key="credentialKey"
     />
   </div>
 </template>
@@ -175,6 +198,7 @@ const lr3dConfig = {
 ```vue
 <LrMapViewer
   :lr3d-config="lr3dConfig"
+  :credential-key="credentialKey"
   :show-region-panel="true"
   :show-debug-panel="true"
 />
@@ -216,6 +240,8 @@ createApp(App).use(LrMapViewerPlugin).mount('#app')
   二维图纸运行时配置。
 - `lr3dConfig`
   龙软三维运行时配置。
+- `credentialKey`
+  内部凭证解密 Key，二维与三维都会使用它解析内置认证信息。
 - `showRegionPanel`
   是否显示区域显隐面板，默认 `false`。
 - `showDebugPanel`
@@ -456,6 +482,7 @@ const lr3dConfig = {
 
 - 组件内部仍兼容完整的 `lr3dConfig` 写法。
 - `basePoint` 推荐传入 `{ x, y, z }` 对象。
+- `sdk.resourcePrefix` 可用于统一给默认的 `/editorapp` 与 `/resource` 路径增加业务前缀，例如 `gkpt -> /gkpt/editorapp/...`、`/gkpt/resource/...`。
 - 如果你需要覆盖 SDK 路径、容器参数、初始化参数等高级配置，仍然可以继续传入 `sdk`、`scene`、`initOptions`、`dataSource` 完整结构。
 
 ## 示例配置