ArcGIS ExperienceBuilder开发版部署及应用构建

一、简介

ExperienceBuilder（简称：EXB）是以无代码或低代码方式创建web应用程序的平台，通过自定义灵活的布局、内容、微件与2D、3D数据交互，可适配不同屏幕尺寸。

其具有以下特点:

• 可创建单页面或多页面应用，可以固定屏幕或滚动屏幕显示

• 在同一个应用中与2D、3D数据交互

• 通过拖拽微件向应用添加可互相关联的工具

• 可为应用设置主题样式

• 可将应用部署到任意设备

• 可创建自定义应用模板

• 在同一位置创建、部署、管理应用

    在 ArcGIS Enterprise 10.8.1/GeoScene Enterprise 2.1中开始引入Experience Builder，分为两个版本：

    1.Enterprise内置版，可通过portal的应用程序启动面板打开

    2.开发版，可独立安装部署，目前仅有ArcGIS

对应API版本

10.8.1及以上内置企业版可直接访问EXB，也可安装开发版搭配使用；10.6-10.8只能安装独立开发版EXB。其相应JSAPI版本如下：

https://developers.arcgis.com/experience-builder/guide/release-versions/

注意：

一般开发版相较于内置版更新频率更高，如果只是想使用最新开发版的微件功能，请完成第二部分的1-7，如果想扩展开发自定义微件功能，请完成第二部分的1-8。

从Enterprise 11.0开始，支持将自定义微件添加到Enterprise使用，低版本只能在开发版中使用。

同一机器可以同时安装多个版本的EXB。

二、在线安装

1.安装Node.js 12及以上，具体需求版本参考对应API版本

2.下载开发版EXB，解压到自定义路径

3.Server模块安装与服务启动

    Server目录位置打开cmd

运行npm ci，自动安装必要模块

    运行npm start，启动Server服务，

注意：

    若使用自定义端口，运行npm start -- --port 81 --https_port 443

    若使用子目录启动server，如https://localhost:3001/subfolder，运行npm start -- --path /subfolder

4.注册到系统服务

    Server路径打开cmd，运行npm run install-windows-service，将服务注册到系统服务，默认名称为exb-server，之后可以在系统服务管理启用/停止。

    5.Portal新建应用程序项目

    下一步补全项目信息，保存即可

6.注册应用程序

    打开刚创建的应用程序项目，点击设置

    划到最下方找到应用程序注册，点击更新

    输入重定向URL，https地址为安装ExperienceBuilder的机器IP加3001端口号，或者https://localhost:3001，点击添加——更新

    复制应用程序ID，备用

7.登录EXB应用程序

    访问EXB地址：https://IP:3001，需信任证书

    输入注册的Enterprise地址及上一步复制的应用程序ID，即可登录

注意：

    EXB默认使用Node.js的自签名证书，也可以替换为自己的证书，步骤是替换server/cert目录下的server.key和server.cert文件。或者使用自定义位置下的证书，运行npm start -- --cert_folder <folder path>

（扩展开发额外需要的安装）

8.Client模块安装与服务启动

    需安装服务以启动webpack来帮助分发自定义组件，

    Client目录位置打开cmd

    运行npm ci，自动安装必要模块

    运行npm start，启动Client服务，

注意：

    在client/your-extensions目录下新建文件或文件夹后，需重启Client服务

三、离线安装

1.本地部署JS API，版本参考对应API

    托管JSAPI的服务器最好设置CORS，比如，Windows系统在HTTPS Response Header添加`Access-Control-Allow-Origin`

2.安装Node.js 12及以上，具体需求版本参考对应API版本

3.下载开发版EXB，解压到自定义路径

4.下载npm-cache.zip，解压到自定义路径

5.拷贝npm-cache

    用户目录打开cmd

    运行npm config get cache，获取缓存位置

拷贝4.中的目录到获取的目录

6.Server、Client模块安装

    分别在Server、Client目录打开cmd，分别运行npm install --offline，安装所需模块

7.更新JS API地址

    打开Client/dist目录

    更新以下四个文件中的arcgisJsApiUrl变量为1.中本地部署的地址

8.启动服务

    分别打开Server、Client目录，运行npm start

9.Portal新建应用程序项目

    下一步补全项目信息，保存即可

10.注册应用程序

    打开刚创建的应用程序项目，点击设置

    划到最下方找到应用程序注册，点击更新

    输入重定向URL，https地址为安装ExperienceBuilder的机器IP加3001端口号，或者https://localhost:3001，点击添加——更新

    复制应用程序ID，备用

11.登录EXB应用程序

    访问EXB地址：https://IP:3001，需信任证书

输入注册的Enterprise地址及上一步复制的应用程序ID，即可登录

注意：

    EXB默认使用Node.js的自签名证书，也可以替换为自己的证书，步骤是替换server/cert目录下的server.key和server.cert文件。或者使用自定义位置下的证书，运行npm start -- --cert_folder <folder path>

四、应用构建

    Enterprise版在portal门户打开ExperienceBuilder应用程序，开发版访问https://域名:3001

1.新建Experience

选择模板

2.添加微件

示例添加了地图微件，拖拽即可

3.添加数据

    只支持web地图、场景服务及web要素图层，其余web图层需先保存为地图或场景

4.配置微件

    选中微件，右侧面板显示可配置项，包括内容、样式、操作。

    比如，选中地图控件，在右侧面板选择地图，为地图空间绑定数据源

5.预览效果

    右上方点击保存——预览

五、官方问题汇总

Esri Support Search Results

参考链接

ArcGIS Experience Builder install | ArcGIS Experience Builder | ArcGIS Developers

欢迎大家沟通交流，点点关注  懒GISer