# 安装指南
**本文引用的文件**
- [geomativestudio.nsi](file://Install/geomativestudio.nsi)
- [dpinst.xml（x64）](file://Install/GD_10/x64/dpinst.xml)
- [dpinst.xml（x86）](file://Install/GD_10/x86/dpinst.xml)
- [config.ini](file://Install/Geomative Studio/config.ini)
- [version_info.txt](file://Install/Geomative Studio/version_info.txt)
- [Setup.rul](file://Install/test1/Script Files/Setup.rul)
- [Setup.map](file://Install/test1/Script Files/Setup.map)
## 目录
1. [简介](#简介)
2. [项目结构与安装包组成](#项目结构与安装包组成)
3. [系统要求与兼容性](#系统要求与兼容性)
4. [安装流程总览](#安装流程总览)
5. [NSIS安装脚本工作机制](#nsis安装脚本工作机制)
6. [组件部署顺序与职责](#组件部署顺序与职责)
7. [驱动程序安装与dpinst.xml作用](#驱动程序安装与dpinstxml作用)
8. [卸载程序生成与注册表清理](#卸载程序生成与注册表清理)
9. [安装失败常见原因与排查](#安装失败常见原因与排查)
10. [故障排除清单](#故障排除清单)
11. [结论](#结论)
## 简介
本指南面向GeomativeStudio桌面应用的完整安装流程，基于仓库中的NSIS安装脚本与配套驱动、运行库、数据库引擎等组件，系统化说明安装目录设置、注册表写入、快捷方式创建、卸载程序生成，以及驱动安装时dpinst.xml的自动安装逻辑。同时提供安装前权限要求、兼容性配置（RUNASADMIN）说明，并结合实际脚本代码路径，帮助用户与运维人员快速定位问题并完成安装。
## 项目结构与安装包组成
- 安装脚本与组件：
- NSIS安装脚本：Install/geomativestudio.nsi
- GD10设备驱动（x64/x86）：Install/GD_10/x64、Install/GD_10/x86
- 运行库：vc_redist.x64.exe、vc_redist.x86.exe
- Access数据库引擎：AccessDatabaseEngine.exe
- 应用程序与工具：Geomative Studio.exe、tools、LOG、DB等
- 兼容性配置：RUNASADMIN注册表项（脚本中预留）
```mermaid
graph TB
A["安装包根目录
Install/"] --> B["NSIS脚本
geomativestudio.nsi"]
A --> C["GD10驱动(x64/x86)"]
A --> D["VC++运行库
vc_redist.x64.exe / vc_redist.x86.exe"]
A --> E["Access数据库引擎
AccessDatabaseEngine.exe"]
A --> F["应用与工具
Geomative Studio.exe / tools / LOG / DB"]
C --> C1["x64/dpinst.xml"]
C --> C2["x86/dpinst.xml"]
```
**图表来源**
- [geomativestudio.nsi](file://Install/geomativestudio.nsi#L70-L110)
- [dpinst.xml（x64）](file://Install/GD_10/x64/dpinst.xml#L1-L19)
- [dpinst.xml（x86）](file://Install/GD_10/x86/dpinst.xml#L1-L19)
**章节来源**
- [geomativestudio.nsi](file://Install/geomativestudio.nsi#L70-L110)
## 系统要求与兼容性
- 权限要求：安装需以管理员身份运行，脚本在初始化阶段强制校验管理员权限。
- 兼容性配置：脚本中包含为可执行文件写入“以管理员身份运行”的注册表项（RUNASADMIN），便于后续兼容旧版系统行为。
- 架构匹配：根据系统位数选择对应组件（x64或x86），确保驱动与运行库正确安装。
**章节来源**
- [geomativestudio.nsi](file://Install/geomativestudio.nsi#L41-L61)
- [geomativestudio.nsi](file://Install/geomativestudio.nsi#L145-L149)
## 安装流程总览
安装流程由NSIS脚本控制，按以下顺序执行：
1. 初始化与权限检查（管理员）
2. 部署核心程序与工具
3. 部署VC++运行库（按系统架构选择）
4. 部署Access数据库引擎
5. 部署GD10驱动（按系统架构选择）
6. 写入注册表与卸载程序
7. 创建开始菜单与桌面快捷方式
```mermaid
sequenceDiagram
participant U as "用户"
participant NSIS as "NSIS安装器"
participant OS as "操作系统/注册表/文件系统"
U->>NSIS : 运行安装包
NSIS->>NSIS : 初始化并请求管理员权限
NSIS->>OS : 写入安装目录与注册表
NSIS->>OS : 部署核心程序与工具
NSIS->>OS : 部署VC++运行库x64/x86
NSIS->>OS : 部署Access数据库引擎
NSIS->>OS : 部署GD10驱动x64/x86
NSIS->>OS : 写入卸载程序与注册表项
NSIS->>OS : 创建开始菜单/桌面快捷方式
NSIS-->>U : 安装完成
```
**图表来源**
- [geomativestudio.nsi](file://Install/geomativestudio.nsi#L58-L61)
- [geomativestudio.nsi](file://Install/geomativestudio.nsi#L70-L110)
- [geomativestudio.nsi](file://Install/geomativestudio.nsi#L111-L138)
- [geomativestudio.nsi](file://Install/geomativestudio.nsi#L140-L143)
- [geomativestudio.nsi](file://Install/geomativestudio.nsi#L158-L163)
- [geomativestudio.nsi](file://Install/geomativestudio.nsi#L166-L175)
- [geomativestudio.nsi](file://Install/geomativestudio.nsi#L191-L200)
- [geomativestudio.nsi](file://Install/geomativestudio.nsi#L185-L189)
## NSIS安装脚本工作机制
- 安装目录与注册表：
- 默认安装目录为Program Files下的GeomativeStudio。
- 写入应用路径到注册表，供卸载程序与开始菜单使用。
- 快捷方式：
- 在开始菜单创建程序组，并在开始菜单与桌面创建快捷方式。
- 卸载程序：
- 生成uninst.exe并在注册表中登记卸载字符串，支持卸载流程。
- 权限与兼容性：
- 请求管理员权限；可选写入RUNASADMIN注册表项以提升兼容性。
**章节来源**
- [geomativestudio.nsi](file://Install/geomativestudio.nsi#L41-L45)
- [geomativestudio.nsi](file://Install/geomativestudio.nsi#L58-L61)
- [geomativestudio.nsi](file://Install/geomativestudio.nsi#L185-L189)
- [geomativestudio.nsi](file://Install/geomativestudio.nsi#L191-L200)
- [geomativestudio.nsi](file://Install/geomativestudio.nsi#L145-L149)
## 组件部署顺序与职责
- 核心程序与工具（Section “Geomative Studio” SEC01）：
- 配置文件、数据库、日志、工具集、版本信息等。
- 驱动程序（Section “Drivers” SEC02）：
- x64与x86目录下分别包含dpinst.xml、驱动INF与SYS文件。
- 数据库引擎（Section “DBConntEngine” SEC03）：
- AccessDatabaseEngine.exe用于支持Access数据库连接。
- 兼容性配置（Section “ASADMIN” SEC04）：
- 可选写入RUNASADMIN注册表项，提升兼容性。
- 运行库安装（Section 自定义段）：
- 按系统架构选择vc_redist.x64.exe或vc_redist.x86.exe执行安装。
- 驱动安装（Section 自定义段）：
- 调用dpinst_amd64.exe或dpinst_x86.exe，指定安装路径参数。
- 卸载清理（Section 卸载）：
- 删除所有已安装文件与注册表项，清理开始菜单与桌面快捷方式。
**章节来源**
- [geomativestudio.nsi](file://Install/geomativestudio.nsi#L70-L110)
- [geomativestudio.nsi](file://Install/geomativestudio.nsi#L111-L138)
- [geomativestudio.nsi](file://Install/geomativestudio.nsi#L140-L143)
- [geomativestudio.nsi](file://Install/geomativestudio.nsi#L145-L149)
- [geomativestudio.nsi](file://Install/geomativestudio.nsi#L158-L163)
- [geomativestudio.nsi](file://Install/geomativestudio.nsi#L166-L175)
- [geomativestudio.nsi](file://Install/geomativestudio.nsi#L213-L287)
## 驱动程序安装与dpinst.xml作用
- dpinst.xml的作用：
- 提供驱动安装向导的标题、欢迎语、安装头信息与完成提示。
- 启用静默安装模式与严格静默策略，减少交互，便于自动化安装。
- 自动安装逻辑：
- NSIS在安装阶段调用dpinst_amd64.exe（x64）或dpinst_x86.exe（x86），并传入安装路径参数，使驱动INF/SYS文件被自动安装。
- 该逻辑通过NSIS内置命令实现，无需用户手动确认。
```mermaid
flowchart TD
Start(["开始"]) --> DetectArch["检测系统架构"]
DetectArch --> IsX64{"是否x64系统？"}
IsX64 --> |是| RunDpinst64["执行dpinst_amd64.exe
参数：/PATH \"$INSTDIR\\x64\""]
IsX64 --> |否| RunDpinst32["执行dpinst_x86.exe
参数：/PATH \"$INSTDIR\\x86\""]
RunDpinst64 --> ReadXml64["读取x64/dpinst.xml
启用静默安装策略"]
RunDpinst32 --> ReadXml32["读取x86/dpinst.xml
启用静默安装策略"]
ReadXml64 --> InstallDrv64["安装驱动INF/SYSx64"]
ReadXml32 --> InstallDrv32["安装驱动INF/SYSx86"]
InstallDrv64 --> End(["结束"])
InstallDrv32 --> End
```
**图表来源**
- [geomativestudio.nsi](file://Install/geomativestudio.nsi#L158-L163)
- [geomativestudio.nsi](file://Install/geomativestudio.nsi#L166-L175)
- [dpinst.xml（x64）](file://Install/GD_10/x64/dpinst.xml#L1-L19)
- [dpinst.xml（x86）](file://Install/GD_10/x86/dpinst.xml#L1-L19)
**章节来源**
- [geomativestudio.nsi](file://Install/geomativestudio.nsi#L158-L175)
- [dpinst.xml（x64）](file://Install/GD_10/x64/dpinst.xml#L1-L19)
- [dpinst.xml（x86）](file://Install/GD_10/x86/dpinst.xml#L1-L19)
## 卸载程序生成与注册表清理
- 卸载程序生成：
- 在Post阶段生成uninst.exe并写入注册表卸载字符串。
- 注册表清理：
- 卸载时删除应用路径、卸载字符串、显示图标、显示版本、发布者等注册表项。
- 文件与快捷方式清理：
- 删除所有安装文件、开始菜单与桌面快捷方式、空目录。
**章节来源**
- [geomativestudio.nsi](file://Install/geomativestudio.nsi#L191-L200)
- [geomativestudio.nsi](file://Install/geomativestudio.nsi#L213-L287)
## 安装失败常见原因与排查
- 权限不足（需要管理员）：
- 现象：安装启动即退出或提示无权限。
- 排查：右键安装包选择“以管理员身份运行”，确保当前用户属于管理员组。
- 参考：脚本在初始化阶段强制校验管理员权限。
- 系统架构不匹配：
- 现象：VC++运行库或驱动安装失败。
- 排查：确认目标系统为x64或x86，确保对应组件被正确选择与安装。
- 参考：脚本根据系统架构选择vc_redist与dpinst。
- 依赖组件安装失败：
- 现象：Access数据库引擎或VC++运行库安装中断。
- 排查：检查系统是否已安装更高版本的运行库或数据库引擎；必要时先卸载冲突版本再重试。
- 目标路径无写权限：
- 现象：安装到Program Files失败或部分文件无法写入。
- 排查：确保安装目录对当前用户具有完全控制权；避免安装到受保护路径。
- 驱动安装异常：
- 现象：驱动安装界面弹出或失败。
- 排查：确认dpinst.xml静默策略生效；检查系统安全策略（如驱动签名）；必要时临时关闭驱动强制签名限制（仅限测试环境）。
**章节来源**
- [geomativestudio.nsi](file://Install/geomativestudio.nsi#L41-L61)
- [geomativestudio.nsi](file://Install/geomativestudio.nsi#L158-L175)
- [Setup.rul](file://Install/test1/Script Files/Setup.rul#L232-L248)
## 故障排除清单
- 安装前准备
- 以管理员身份运行安装包
- 关闭杀毒软件或防火墙（临时）
- 确认磁盘空间充足
- 安装中关注
- VC++运行库安装是否出现静默窗口
- Access数据库引擎是否静默完成
- 驱动安装是否静默完成（dpinst.xml启用quietInstallStrict）
- 安装后验证
- 开始菜单与桌面快捷方式是否存在
- 应用程序可正常启动
- 数据库连接功能可用
- 设备驱动已加载（可在设备管理器查看）
**章节来源**
- [geomativestudio.nsi](file://Install/geomativestudio.nsi#L158-L175)
- [dpinst.xml（x64）](file://Install/GD_10/x64/dpinst.xml#L1-L19)
- [dpinst.xml（x86）](file://Install/GD_10/x86/dpinst.xml#L1-L19)
## 结论
本指南基于仓库中的NSIS安装脚本与驱动、运行库、数据库引擎等组件，给出了完整的安装流程说明与排障建议。通过理解安装目录设置、注册表写入、快捷方式创建、卸载程序生成以及驱动安装的自动逻辑，用户与运维人员可以更高效地完成GeomativeStudio的部署与维护工作。遇到问题时，优先检查管理员权限、系统架构匹配与依赖组件状态，通常可快速定位并解决问题。