1. 项目概述为什么要在UE5里集成真实世界地图如果你正在用Unreal Engine 5捣鼓一个开放世界项目或者想做一个城市规划的演示又或者想搞点严肃的模拟训练那你大概率会遇到一个头疼的问题地图从哪儿来是自己用Landscape工具手捏还是去网上找现成的高度图手捏的精度和真实感有限网上的数据又往往不成体系而且最关键的是——它们和真实的地理坐标对不上。这就是ArcGIS Maps SDK for Unreal Engine这个插件要解决的核心痛点。简单说它是一座桥一头连着全球最顶级的专业地理信息系统GIS平台ArcGIS另一头连着最强大的实时渲染引擎UE5。通过这座桥你可以把真实世界的地形、影像、建筑、道路甚至实时交通数据直接“流式”导入到你的UE5项目里。你不再需要处理TB级别的本地地形数据插件会帮你按需加载让你能在编辑器里或运行时浏览从你家后院到珠穆朗玛峰的任意区域并且所有数据都带有精确的地理坐标。听起来很酷但安装过程对于刚接触的人来说可能像在走迷宫。官方文档虽然详尽但步骤分散且默认你已经熟悉了UE5的插件管理和C编译环境。网上零散的教程又可能因为版本过时而踩坑。这篇内容就是把我自己从零开始在UE5.3环境下成功安装并跑通第一个示例项目的完整过程、遇到的坑以及解决思路掰开揉碎了分享给你。无论你是游戏开发者、建筑可视化设计师还是GIS领域的跨界探索者只要你想在UE5里用上真实地理数据这篇指南都能帮你省下大量摸索的时间。2. 环境准备与前置条件检查在点击下载按钮之前有几项关键的准备工作必须到位这能避免你走到一半才发现路不通白白浪费时间。2.1 硬件与操作系统要求首先你的机器得够劲。处理全球地理数据尤其是高精度的3D建筑如Esri的集成网格场景层对硬件要求不低。操作系统Windows 10 64位版本1909或更高或 Windows 11。这是硬性要求插件不支持Mac或Linux。显卡必须支持DirectX 12。推荐NVIDIA RTX 2070或更高性能的显卡。集成显卡或老旧显卡可能无法正常运行或在加载复杂3D场景时崩溃。内存强烈建议32GB或以上。16GB是官方最低要求但在同时运行UE5编辑器、加载地形和影像数据时会非常吃力频繁触发虚拟内存交换导致编辑器卡顿甚至无响应。存储空间你需要为UE5引擎本身约30-40GB、你的项目以及ArcGIS插件预留充足空间。插件本身不大但缓存的地图数据会随着你的浏览区域扩大而增长。建议系统盘通常是C盘至少有50GB可用空间因为一些临时文件和开发工具默认安装在这里。注意很多安装失败的问题根源在于C盘空间不足。UE5编译过程中会产生大量中间文件如果C盘红了编译会直接失败。2.2 软件依赖项安装这是安装环节最容易出错的“雷区”。ArcGIS插件本质上是一个需要编译的C插件它依赖一系列外部工具链。Visual Studio 2022这是最重要的依赖。你不能只安装VS Code。版本必须安装Visual Studio 2022社区版免费。工作负载安装时务必勾选“使用C的桌面开发”这个工作负载。在右侧的“安装详细信息”中必须确保“Windows 10 SDK (10.0.19041.0)”或更高版本被选中。UE5.3通常与这个版本的SDK兼容性最好。如果不知道选哪个就勾上它。为什么必须装UE5的源码版本引擎和C项目编译都依赖VS提供的编译器MSVC、链接器和C标准库。没有它后续的编译步骤寸步难行。.NET Framework通常Windows 10/11已内置但建议通过Windows功能确保已启用。部分安装程序或工具可能需要。Git虽然不是强制但强烈建议安装。Esri的示例项目和一些依赖库的管理可能会用到Git。安装时选择“Git from the command line and also from 3rd-party software”这样可以从任何地方调用git命令。2.3 Unreal Engine 5版本选择与获取插件的版本与UE5引擎版本必须严格匹配。当前推荐截至撰写时ArcGIS Maps SDK for Unreal Engine 的最新稳定版本是1.0其官方兼容的UE5版本是5.3。请前往Epic Games启动器在“虚幻引擎”标签页中点击“引擎版本”旁边的“”号选择5.3版本进行安装。不要使用5.0、5.1或5.2即使能装上也可能出现无法预料的运行时错误。安装类型你需要安装源码版本Source的UE5而不是启动器里预编译的二进制版本。因为插件安装过程中需要修改引擎的构建文件并重新编译引擎模块。在安装5.3时勾选“引擎源码”选项。安装路径避免使用包含中文或特殊字符的路径例如D:\Program Files\UE_5.3是安全的D:\游戏开发\UE5.3则可能引发问题。完成以上三步你的基础环境才算搭建完毕。可以把它想象成盖房子前打好了地基和准备好了水泥、砖块。接下来我们开始获取和安装插件本身。3. 插件获取与项目工程设置插件本身不直接从Epic的商城获取而是需要从Esri的开发者网站下载并手动集成到你的项目中。3.1 注册Esri账户与下载SDK访问开发者网站打开浏览器访问developers.arcgis.com。注册/登录点击右上角“Sign In”如果你没有Esri账户需要免费注册一个。这个过程很简单只需邮箱、姓名和设置密码。查找SDK登录后在顶部导航栏找到“Products” - “ArcGIS Maps SDKs”在列表中找到“ArcGIS Maps SDK for Unreal Engine”。或者直接在站内搜索“Unreal”。下载进入该SDK的主页后你应该能看到一个显眼的“Download”按钮。点击它你会被要求填写一些简单的信息如用途、公司等填写后即可开始下载。下载的文件通常是一个名为类似ArcGIS_Maps_SDK_for_Unreal_Engine_1_0.zip的压缩包。3.2 创建并准备UE5 C项目你不能把插件安装到一个空的文件夹或者蓝图项目里必须是一个C项目。启动UE5.3通过Epic Games启动器启动你刚安装好的UE5.3引擎。创建新项目在项目浏览器中选择“游戏”类别或其他类别但游戏模板最通用。选择“空白”或“第三人称”模板推荐“空白”更干净。关键步骤来了在右下角的“项目默认设置”中必须将“项目类型”从“蓝图”切换为“C”。给你的项目起个名字例如MyGISProject。选择项目存储路径同样请使用全英文路径。点击“创建”。UE5会自动为你生成一个C项目解决方案并用Visual Studio 2022打开它。第一次创建会花费一些时间因为它需要生成所有必要的文件并编译基础模块。关闭编辑器在继续操作前务必完全关闭Unreal Editor编辑器窗口。在插件文件被复制到正确位置前保持编辑器关闭可以避免文件锁冲突。3.3 集成插件文件到项目这是将插件“放入”UE5项目结构中的步骤。解压下载的ZIP包将之前下载的ArcGIS_Maps_SDK_for_Unreal_Engine_1_0.zip解压到一个临时文件夹。你会看到里面包含文档Documentation、示例Samples和最重要的Plugins文件夹。定位项目插件目录在你的项目根目录下例如D:\MyProject\MyGISProject你会看到一个Source文件夹。与它同级新建一个名为Plugins的文件夹如果不存在的话。复制插件将解压出来的ZIP包内的Plugins文件夹整个复制到你项目刚创建或已有的Plugins目录下。复制完成后你的项目结构应该类似于MyGISProject/ ├── Content/ ├── Saved/ ├── Source/ │ └── MyGISProject/ ├── Plugins/ -- 你创建的 │ └── ArcGISMapsSDK/ -- 从ZIP包复制来的整个文件夹 │ ├── Resources/ │ ├── Source/ │ └── ArcGISMapsSDK.uplugin └── MyGISProject.uproject验证关键文件确保Plugins/ArcGISMapsSDK/目录下存在一个名为ArcGISMapsSDK.uplugin的描述文件。这个文件是UE5识别插件的关键。至此插件的“身体”已经就位但它还没有被激活也无法工作。接下来我们需要修改项目的构建配置告诉UE5在编译时包含这个插件。4. 核心配置与引擎编译这是整个安装过程中技术性最强、也最容易报错的环节。我们需要手动编辑项目配置文件然后触发一次完整的引擎模块编译。4.1 修改项目构建文件 (.Build.cs)UE5使用C#构建脚本来定义项目的编译规则。我们需要告诉它“嘿我这个项目要用ArcGIS插件请把它包含进来。”找到构建文件在你的项目Source目录下有一个以你项目名命名的文件夹如MyGISProject里面会有一个MyGISProject.Build.cs文件。用任意文本编辑器如VS Code、Notepad打开它。添加插件依赖在这个文件中找到PublicDependencyModuleNames这个列表。我们需要在其中添加插件的模块名。修改后的部分看起来应该像这样public class MyGISProject : ModuleRules { public MyGISProject(ReadOnlyTargetRules Target) : base(Target) { PCHUsage PCHUsageMode.UseExplicitOrSharedPCHs; // 原有的依赖如Core, CoreUObject, Engine, Input等保持不变 PublicDependencyModuleNames.AddRange(new string[] { Core, CoreUObject, Engine, InputCore }); // 新增以下两行声明对ArcGIS插件模块的依赖 PublicDependencyModuleNames.AddRange(new string[] { ArcGISMapsSDK, ArcGISMapsSDKEditor // 这个是编辑器模块如果你只在运行时用可以不加。但为了完整功能建议加上。 }); // ... 文件后续的其他代码保持不变 } }ArcGISMapsSDK这是插件的主要运行时模块。ArcGISMapsSDKEditor这是插件的编辑器模块提供了在UE编辑器内操作地图的UI面板和工具。如果你确定你的项目最终打包后不需要在编辑器里编辑地图可以只添加运行时模块。但对于学习和开发阶段强烈建议两个都加上。4.2 生成项目文件与打开解决方案修改完.Build.cs后UE5需要重新生成Visual Studio的解决方案文件来反映这个变化。右键点击 .uproject 文件在文件资源管理器中找到你的项目根目录下的MyGISProject.uproject文件。生成项目文件右键点击它在上下文菜单中会出现“Generate Visual Studio project files”选项。点击它。这个过程很快会在命令行窗口闪过一些信息。如果成功你会看到MyGISProject.sln文件被更新。如果右键菜单没有这个选项你可能需要先安装.NET Framework或者手动操作以管理员身份打开“命令提示符”或“PowerShell”导航到你的UE5引擎安装目录下的Engine\Binaries\DotNET文件夹运行UnrealBuildTool.exe。但通常直接右键是最快的方式。打开解决方案双击更新后的MyGISProject.sln文件在Visual Studio 2022中打开你的项目。4.3 编译项目与插件模块现在我们需要在VS里启动编译。注意这不是普通的“生成解决方案”因为插件是源码形式需要和你的项目一起编译。设置解决方案配置在VS顶部的工具栏确保“解决方案配置”是Development Editor“解决方案平台”是Win64。这是为在编辑器内开发而编译的配置。执行编译在解决方案资源管理器中右键点击你的项目名如MyGISProject选择“生成”Build。或者你可以从菜单栏选择“生成” - “生成解决方案”。耐心等待这是最耗时的步骤可能需要10到30分钟取决于你的电脑性能。控制台会输出大量的编译信息。第一次编译会同时编译插件模块和你自己的项目模块。你会看到它正在处理ArcGISMapsSDK和ArcGISMapsSDKEditor。检查编译结果编译完成后查看VS的“输出”窗口最后应该显示“ 生成: 成功 1 个失败 0 个最新 0 个跳过 0 个 ”。如果有错误请仔细阅读错误信息。最常见的错误是找不到头文件通常是因为.Build.cs文件修改有误或者插件路径不对。请回头检查第4.1和3.3步。链接错误可能缺少某些库或者VS工作负载没装全。请回顾第2.2步确保Windows 10 SDK已安装。编译工具链错误检查VS2022安装是否完整。编译成功是万里长征走完了90%。现在插件已经成功集成并编译到你的项目中了。5. 插件启用与基础功能验证编译通过只是意味着代码没问题了我们还需要在UE5编辑器里启用插件并创建一个简单的地图来验证一切工作正常。5.1 在编辑器中启用插件启动项目在Visual Studio中确保编译成功后你可以点击工具栏上的“本地Windows调试器”旁边的下拉箭头选择“MyGISProject调试”来启动编辑器。或者直接关闭VS双击.uproject文件启动。打开插件窗口UE5编辑器启动后在菜单栏点击“编辑”Edit - “插件”Plugins。搜索并启用在插件浏览器的搜索框中输入“ArcGIS”。你应该能看到“ArcGIS Maps SDK”和“ArcGIS Maps SDK Editor”两个插件。勾选它们旁边的“已启用”复选框。编辑器会提示需要重启才能使插件生效。重启编辑器点击“立即重启”按钮。编辑器关闭并重新启动。5.2 创建首个ArcGIS地图场景编辑器重启后如果插件启用成功你会在界面上看到新的变化。找到模式面板在编辑器左侧的“模式”Modes面板中除了默认的“放置”、“地形”等现在应该多了一个“ArcGIS”标签页。点击它。添加ArcGIS地图组件在ArcGIS模式面板下你会看到几个可拖放的组件最主要的是“ArcGIS Map”。直接将它拖拽到你的场景视口中或者拖到世界大纲视图World Outliner里。这会在你的关卡中创建一个ArcGISMapComponent。配置API密钥关键步骤选中刚刚创建的ArcGISMapComponent在右侧的“细节”Details面板中找到“ArcGIS Map”分类。这里有一个至关重要的属性“API Key”。获取API Key回到你的浏览器登录developers.arcgis.com。在右上角你的账户头像处点击选择“API keys”。点击“New API key”为你的项目起个名字如“My UE5 Project”然后创建。创建成功后你会看到一长串字符串这就是你的API Key。它相当于访问Esri在线地图服务的通行证。有免费额度对于学习和测试完全足够。填入密钥将复制的API Key粘贴到UE5编辑器细节面板的“API Key”字段中。配置底图与高程底图Basemap在细节面板中找到“Basemap”。你可以从下拉列表中选择一个预设的底图样式例如“ArcGIS: Imagery”卫星影像或“ArcGIS: Topographic”地形图。选择“ArcGIS: Imagery”视觉效果最直观。高程Elevation找到“Elevation”属性。同样从下拉列表中选择一个高程源例如“ArcGIS: World Elevation”。这决定了地形的起伏。设置初始位置Viewport为了让地图加载到你感兴趣的区域你需要设置一个初始的地理范围。在细节面板中找到“Viewport”分类。位置Location输入一个经纬度坐标。例如你可以输入纽约的坐标纬度40.7128经度-74.0060。高度Altitude设置相机初始海拔高度单位是米。例如2000000200万米会给你一个全球视角10000则会拉近很多。朝向Heading/Roll/Pitch控制相机的旋转角度可以先保持默认000。5.3 运行与问题初步排查配置完成后点击编辑器顶部的“运行”Play按钮。如果你的场景中除了天空什么都没有别急数据正在流式加载。观察加载过程查看屏幕左上角或左下角取决于插件版本通常会有加载提示。你也可以打开“输出日志”Window - Developer Tools - Output Log查看更详细的信息。看到地图了几秒到几十秒后取决于网速和区域复杂度你应该能看到卫星影像和地形在视口中逐渐渲染出来。你可以用鼠标右键拖拽旋转滚轮缩放或游戏手柄来浏览这个真实的世界地图。常见初期问题一片灰/蓝无地图检查API Key这是最常见的原因。确认Key已正确粘贴且没有多余空格。可以回到开发者网站确认该Key是“Active”状态。检查网络确保你的机器可以访问Esri的在线服务。有时公司防火墙或代理会屏蔽。地形是平的没有起伏确认“Elevation”属性已正确设置为“ArcGIS: World Elevation”或其他高程源。尝试缩放到一个多山区域如阿尔卑斯山、落基山脉看看。编辑器卡顿或崩溃可能是硬件内存不足。尝试降低视口分辨率或缩小加载范围通过调整Viewport的高度飞得更高看得更广但细节少。检查显卡驱动是否为最新。当你成功看到带有真实地形起伏的卫星影像时恭喜你ArcGIS Maps SDK for Unreal Engine插件已经成功安装并运行起来了你已经打开了将真实地理空间数据融入实时3D体验的大门。6. 深入配置与性能调优指南插件跑起来只是第一步。要想在项目中高效、稳定地使用它你需要了解一些核心配置和性能调优技巧。这部分内容往往官方文档不会细说但却决定了项目的成败。6.1 理解图层系统与数据源ArcGIS插件采用分层加载数据的概念理解这个模型至关重要。图层类型在ArcGISMapComponent的细节面板中你会发现除了Basemap和Elevation还有“Layers”数组。你可以在这里添加各种类型的图层影像图层Image Layer提供卫星或航拍图片。3D对象图层3D Object Layer加载带有纹理的3D建筑模型如Esri的集成网格场景层这是创建逼真城市环境的关键。要素图层Feature Layer加载矢量数据如道路线、行政区划面、兴趣点。这些数据可以被UE5的材质系统着色甚至用于游戏逻辑如碰撞检测、寻路。数据源管理每个图层都需要一个“数据源”。数据源可以是在线服务最常用的方式指向一个ArcGIS Online或ArcGIS Enterprise上的服务URL。优点是数据实时更新无需本地存储。本地数据插件也支持加载本地的切片包TPK、场景图层包SLPK等。这对于保密项目或离线环境是必须的。你需要将数据包放入项目的Content目录下然后在数据源中选择“Local”并指定路径。图层顺序与混合图层的顺序决定了渲染的上下关系。通常底图在最下层然后是高程接着是影像或要素3D对象层在最上层。你可以通过调整图层数组的顺序来控制。对于半透明的要素图层混合模式Blend Mode的设置会影响其与下层图像的融合效果。6.2 视口配置与LOD策略如何控制地图加载的范围和细节层次LOD是平衡视觉效果与性能的核心。视口Viewport详解Viewport不仅定义了初始位置更控制了运行时数据加载的“窗口”。视场角Field of View这个值模拟了相机的镜头焦距。广角如90度会看到更广阔但边缘畸变的区域导致需要加载的数据范围更大。窄角如60度则更像长焦镜头加载范围小但更集中。对于大地图浏览建议使用60-75度的视场角以优化加载范围。视距范围Near/Far Clip Plane定义了相机的可见范围。太近的物体会被裁剪太远的物体也不会渲染。合理设置可以避免加载视线之外的无效数据。一般Near设为1Far根据你的最大可视距离设置比如10000010万米。LOD与细节控制自动LOD插件默认会根据相机与地面的距离自动请求不同细节级别的数据。距离越近加载的数据精度越高纹理分辨率更高模型更精细。手动限制你可以在图层属性中手动设置最小和最大LOD级别强制它在某个细节范围内加载。例如对于远山背景你可以限制其最大LOD为低级别避免加载不必要的精细模型节省内存和带宽。缓存管理插件会自动缓存已加载的数据到本地磁盘默认在用户目录的AppData下。你可以设置缓存大小上限。定期清理缓存或增大缓存空间能显著提升重复访问区域的速度。6.3 性能分析与优化实战在UE5编辑器里运行带有全球地图的项目对性能是巨大挑战。以下是我在实践中总结的优化清单编辑器内性能工具Stat Unit在运行时按CtrlShift,逗号可以显示性能统计。关注Game和Draw线程的时间。如果Game线程耗时高可能是蓝图逻辑或数据解析问题如果Draw线程高则是渲染压力大。GPU Visualizer按CtrlShift,后输入profilegpu可以查看GPU各阶段的耗时。ArcGIS插件大量使用纹理流送关注Texture Streaming和Base Pass。关键优化参数纹理流送池大小Texture Streaming Pool Size在项目设置Edit - Project Settings中搜索“Texture Streaming”。根据你的显卡显存如8GB合理设置池大小如设置为显存的70%即6000MB。设置过小会导致纹理频繁流进流出造成卡顿过大则可能爆显存。屏幕百分比Screen Percentage在编辑器视口或运行时的分辨率设置中可以暂时调低如80%来快速提升帧率特别是在调试阶段。关闭动态阴影对于远距离的地形和建筑动态阴影开销巨大。可以考虑使用烘焙的阴影贴图Lightmap或关闭某些图层的阴影投射。内容层面的优化分块加载Tile Loading理解插件是按“瓦片”加载数据的。避免让相机在短时间内快速掠过巨大区域如从亚洲瞬间飞到美洲这会导致大量瓦片请求排队造成卡顿。可以通过蓝图限制相机的最大移动速度。图层可见性控制不要一次性激活所有图层。根据玩家所在区域如城市内才显示3D建筑野外只显示地形和影像动态启用或禁用图层。这可以通过蓝图检测玩家位置并调用Set Layer Visibility节点来实现。使用代理几何体Proxy Geometry对于极远处的山脉可以使用简化的代理网格代替复杂的高程数据这在高空飞行时能大幅提升性能。这需要一些自定义的蓝图或C开发。7. 从示例项目到自主开发Esri提供的示例项目是绝佳的学习资源但如何将其转化为你自己的项目资产这里有些门道。7.1 剖析官方示例项目在下载的SDK包中Samples文件夹里通常包含一个完整的UE5示例项目。不要直接在这个项目上开发而是应该学习它。打开示例项目将Samples文件夹下的.uproject文件复制到另一个位置避免污染原文件然后右键生成项目文件并打开。首次打开会提示缺失模块选择“是”进行编译。学习核心蓝图重点关注以下几个方面地图控制器ArcGIS Map Controller示例中通常有一个Pawn或Actor上面挂载了控制地图移动、旋转、缩放的逻辑。学习它如何将玩家输入鼠标、键盘、游戏手柄转换为对ArcGISMapComponent的Viewport属性的操作。UI交互示例如何实现UI控件如搜索框、图层列表与地图组件的交互。这涉及到蓝图与C插件的通信。数据绑定如何将地图的属性如当前经纬度、海拔实时更新到UI文本上。复制与适配不要复制粘贴整个蓝图。而是理解其原理后在你的项目中重建核心功能。例如你可以将示例中的“地图移动控制”逻辑抽取出来做成一个组件Component然后挂载到你自己的角色Pawn上。7.2 构建自定义交互逻辑掌握了基础你就可以开始打造独特的体验了。地理空间查询插件提供了强大的查询功能。你可以在蓝图中通过“Get Feature Layer”节点获取图层然后使用“Query Features”节点根据空间范围如一个圆形区域或属性条件如“名称包含‘公园’”查询要素。查询结果可以用于生成任务目标、动态放置物体等。坐标转换这是GIS的核心。插件内部使用“工程坐标系”通常是Web墨卡托投影。但你需要与UE5的世界坐标厘米为单位进行转换。插件提供了关键的蓝图节点Geographic To World将经纬度高程Longitude, Latitude, Altitude转换为UE世界坐标X, Y, Z。World To Geographic反向转换。实操心得在放置一个基于真实坐标的物体时务必先进行坐标转换。例如你想在纽约帝国大厦的楼顶已知经纬度放置一个特效你需要先用Geographic To World节点计算出UE世界坐标再用这个坐标生成你的特效Actor。动态图层加载实现一个“视野管理器”。创建一个定时器或每帧事件获取当前相机视口的中心点地理坐标和范围。然后根据这个范围判断需要加载或卸载哪些附加图层比如远离城市时卸载3D建筑层进入城市范围再加载。这能极大优化内存使用。7.3 打包与部署注意事项当你的项目开发完成准备打包成可执行文件分发时有几个关键点。插件包含设置在打包前务必在“编辑”-“插件”中确认ArcGIS Maps SDK插件是“已启用”状态。UE5在打包时默认只会包含已启用的插件。API Key的安全处理你绝对不应该将API Key硬编码在蓝图中或打包进客户端。对于单机演示版一种相对安全的方式是在打包后创建一个外部的配置文件如Config.ini让程序在启动时读取这个文件中的API Key。对于需要联网的公开项目你应该搭建一个简单的后端服务由服务端持有API Key客户端向你的服务端请求地图数据由服务端转发请求到ArcGIS。这需要一些Web开发知识。数据缓存与离线模式如果你的项目有离线运行的需求你需要预先将所需区域的地图数据底图、高程、3D建筑打包成本地数据包如TPKX, SLPK并在插件中配置使用本地数据源。Esri提供了ArcGIS Pro等工具来制作这些离线包。在打包时将这些数据包放入项目的Content目录下并确保在插件设置中正确引用。打包后测试在Development或Shipping模式下打包后务必在目标机器上进行测试。检查地图是否能正常加载性能是否可接受所有交互功能是否正常。特别注意首次运行时数据缓存造成的延迟。安装和配置只是起点真正的挑战和乐趣在于如何利用这个强大的工具将真实世界的数据与虚幻引擎天马行空的创造力结合起来。从创建一个基于真实地形的飞行模拟器到构建一个数字孪生城市管理平台可能性只受限于你的想象力。记住遇到问题多查官方文档虽然有时晦涩多利用开发者社区很多坑其实前辈们都踩过。