geomative/GeomativeStudio/.qoder/repowiki/zh/content/安装与配置/安装指南.md

安装指南

**本文引用的文件** - [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安装脚本工作机制
6. 组件部署顺序与职责
7. 驱动程序安装与dpinst.xml作用
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注册表项（脚本中预留）

graph TB
A["安装包根目录<br/>Install/"] --> B["NSIS脚本<br/>geomativestudio.nsi"]
A --> C["GD10驱动(x64/x86)"]
A --> D["VC++运行库<br/>vc_redist.x64.exe / vc_redist.x86.exe"]
A --> E["Access数据库引擎<br/>AccessDatabaseEngine.exe"]
A --> F["应用与工具<br/>Geomative Studio.exe / tools / LOG / DB"]
C --> C1["x64/dpinst.xml"]
C --> C2["x86/dpinst.xml"]

图表来源

• geomativestudio.nsi
• dpinst.xml（x64）
• dpinst.xml（x86）

章节来源

• geomativestudio.nsi

系统要求与兼容性

• 权限要求：安装需以管理员身份运行，脚本在初始化阶段强制校验管理员权限。
• 兼容性配置：脚本中包含为可执行文件写入“以管理员身份运行”的注册表项（RUNASADMIN），便于后续兼容旧版系统行为。
• 架构匹配：根据系统位数选择对应组件（x64或x86），确保驱动与运行库正确安装。

章节来源

• geomativestudio.nsi
• geomativestudio.nsi

安装流程总览

安装流程由NSIS脚本控制，按以下顺序执行：

1. 初始化与权限检查（管理员）
2. 部署核心程序与工具
3. 部署VC++运行库（按系统架构选择）
4. 部署Access数据库引擎
5. 部署GD10驱动（按系统架构选择）
6. 写入注册表与卸载程序
7. 创建开始菜单与桌面快捷方式

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
• geomativestudio.nsi
• geomativestudio.nsi
• geomativestudio.nsi
• geomativestudio.nsi
• geomativestudio.nsi
• geomativestudio.nsi
• geomativestudio.nsi

NSIS安装脚本工作机制

• 安装目录与注册表：
  • 默认安装目录为Program Files下的GeomativeStudio。
  • 写入应用路径到注册表，供卸载程序与开始菜单使用。
• 快捷方式：
  • 在开始菜单创建程序组，并在开始菜单与桌面创建快捷方式。
• 卸载程序：
  • 生成uninst.exe并在注册表中登记卸载字符串，支持卸载流程。
• 权限与兼容性：
  • 请求管理员权限；可选写入RUNASADMIN注册表项以提升兼容性。

章节来源

• geomativestudio.nsi
• geomativestudio.nsi
• geomativestudio.nsi
• geomativestudio.nsi
• geomativestudio.nsi

组件部署顺序与职责

• 核心程序与工具（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
• geomativestudio.nsi
• geomativestudio.nsi
• geomativestudio.nsi
• geomativestudio.nsi
• geomativestudio.nsi
• geomativestudio.nsi

驱动程序安装与dpinst.xml作用

• dpinst.xml的作用：
  • 提供驱动安装向导的标题、欢迎语、安装头信息与完成提示。
  • 启用静默安装模式与严格静默策略，减少交互，便于自动化安装。
• 自动安装逻辑：
  • NSIS在安装阶段调用dpinst_amd64.exe（x64）或dpinst_x86.exe（x86），并传入安装路径参数，使驱动INF/SYS文件被自动安装。
  • 该逻辑通过NSIS内置命令实现，无需用户手动确认。

flowchart TD
Start(["开始"]) --> DetectArch["检测系统架构"]
DetectArch --> IsX64{"是否x64系统？"}
IsX64 --> |是| RunDpinst64["执行dpinst_amd64.exe<br/>参数：/PATH \"$INSTDIR\\x64\""]
IsX64 --> |否| RunDpinst32["执行dpinst_x86.exe<br/>参数：/PATH \"$INSTDIR\\x86\""]
RunDpinst64 --> ReadXml64["读取x64/dpinst.xml<br/>启用静默安装策略"]
RunDpinst32 --> ReadXml32["读取x86/dpinst.xml<br/>启用静默安装策略"]
ReadXml64 --> InstallDrv64["安装驱动INF/SYSx64"]
ReadXml32 --> InstallDrv32["安装驱动INF/SYSx86"]
InstallDrv64 --> End(["结束"])
InstallDrv32 --> End

图表来源

• geomativestudio.nsi
• geomativestudio.nsi
• dpinst.xml（x64）
• dpinst.xml（x86）

章节来源

• geomativestudio.nsi
• dpinst.xml（x64）
• dpinst.xml（x86）

卸载程序生成与注册表清理

• 卸载程序生成：
  • 在Post阶段生成uninst.exe并写入注册表卸载字符串。
• 注册表清理：
  • 卸载时删除应用路径、卸载字符串、显示图标、显示版本、发布者等注册表项。
• 文件与快捷方式清理：
  • 删除所有安装文件、开始菜单与桌面快捷方式、空目录。

章节来源

• geomativestudio.nsi
• geomativestudio.nsi

安装失败常见原因与排查

• 权限不足（需要管理员）：
  • 现象：安装启动即退出或提示无权限。
  • 排查：右键安装包选择“以管理员身份运行”，确保当前用户属于管理员组。
  • 参考：脚本在初始化阶段强制校验管理员权限。
• 系统架构不匹配：
  • 现象：VC++运行库或驱动安装失败。
  • 排查：确认目标系统为x64或x86，确保对应组件被正确选择与安装。
  • 参考：脚本根据系统架构选择vc_redist与dpinst。
• 依赖组件安装失败：
  • 现象：Access数据库引擎或VC++运行库安装中断。
  • 排查：检查系统是否已安装更高版本的运行库或数据库引擎；必要时先卸载冲突版本再重试。
• 目标路径无写权限：
  • 现象：安装到Program Files失败或部分文件无法写入。
  • 排查：确保安装目录对当前用户具有完全控制权；避免安装到受保护路径。
• 驱动安装异常：
  • 现象：驱动安装界面弹出或失败。
  • 排查：确认dpinst.xml静默策略生效；检查系统安全策略（如驱动签名）；必要时临时关闭驱动强制签名限制（仅限测试环境）。

章节来源

• geomativestudio.nsi
• geomativestudio.nsi
• [Setup.rul](file://Install/test1/Script Files/Setup.rul#L232-L248)

故障排除清单

• 安装前准备
  • 以管理员身份运行安装包
  • 关闭杀毒软件或防火墙（临时）
  • 确认磁盘空间充足
• 安装中关注
  • VC++运行库安装是否出现静默窗口
  • Access数据库引擎是否静默完成
  • 驱动安装是否静默完成（dpinst.xml启用quietInstallStrict）
• 安装后验证
  • 开始菜单与桌面快捷方式是否存在
  • 应用程序可正常启动
  • 数据库连接功能可用
  • 设备驱动已加载（可在设备管理器查看）

章节来源

• geomativestudio.nsi
• dpinst.xml（x64）
• dpinst.xml（x86）

结论

本指南基于仓库中的NSIS安装脚本与驱动、运行库、数据库引擎等组件，给出了完整的安装流程说明与排障建议。通过理解安装目录设置、注册表写入、快捷方式创建、卸载程序生成以及驱动安装的自动逻辑，用户与运维人员可以更高效地完成GeomativeStudio的部署与维护工作。遇到问题时，优先检查管理员权限、系统架构匹配与依赖组件状态，通常可快速定位并解决问题。