admin/geomative
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
df489d5640f2c690624c7995102ecde5511a4d56
geomative/GeomativeStudio/.qoder/repowiki/zh/content/安装与配置/安装指南.md
T
coco df489d5640 a
2026-07-03 16:05:30 +08:00

237 lines
12 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 安装指南
<cite>
**本文引用的文件**
- [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)
</cite>
## 目录
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["安装包根目录<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](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<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](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的部署与维护工作。遇到问题时，优先检查管理员权限、系统架构匹配与依赖组件状态，通常可快速定位并解决问题。
Reference in New Issue View Git Blame Copy Permalink