安装说明

本工具为跨平台桌面应用，提供 Windows、macOS、Linux 三个平台的安装包。应用已内置完整 GDAL 运行时，安装后即可使用，无需额外配置环境。

系统要求

平台	最低版本	架构	备注
Windows	Windows 10 1809+	x64	推荐 Windows 11
macOS	macOS 10.15 (Catalina)+	x64 / ARM64	支持 Apple Silicon
Linux	Ubuntu 18.04+ / CentOS 7+	x64	需图形界面

• 内存：建议 4GB 以上（大范围下载建议 8GB+）
• 磁盘空间：安装约 300MB，下载缓存视范围与级别而定
• 网络：下载瓦片需要可访问瓦片服务器（默认 ESRI）

Windows 安装

1. 获取安装包 离线地图下载工具-1.0.0-setup.exe
2. 双击运行安装程序
3. 选择安装目录（可自定义）
4. 安装程序会自动创建桌面快捷方式与开始菜单项
5. 安装完成后即可从桌面快捷方式启动

桌面快捷方式

安装时默认勾选「创建桌面快捷方式」与「创建开始菜单快捷方式」，快捷方式名称为「离线地图下载工具」。

管理员权限

安装程序默认以「每台机器」（perMachine）模式安装，可能需要管理员权限。安装程序支持 UAC 提权。

macOS 安装

1. 获取安装包 map-download-1.0.0.dmg
2. 双击挂载 DMG 镜像
3. 将「离线地图下载工具」拖入「Applications」文件夹
4. 首次启动时，右键点击应用 → 选择「打开」→ 在弹窗中确认「打开」

Gatekeeper 提示

由于应用未经过 Apple 公证（notarize），首次启动可能提示「无法打开」。请前往「系统设置 → 隐私与安全性」点击「仍要打开」。

Linux 安装

提供三种发行包：

# AppImage（免安装，直接运行）
chmod +x map-download-1.0.0.AppImage
./map-download-1.0.0.AppImage

# Debian / Ubuntu
sudo dpkg -i map-download_1.0.0_amd64.deb

# Snap
sudo snap install map-download_1.0.0_amd64.snap --dangerous

GDAL 运行时

应用已内置完整的 GDAL 工具链，包括：

• gdalwarp — 重投影
• gdal_translate — 格式转换与裁剪
• gdalbuildvrt — VRT 构建
• gdalinfo — 栅格信息查询
• ogr2ogr — 矢量转换
• sqlite3 — SQLite 数据库操作

打包后，GDAL 资源位于应用安装目录的 resources/gdal/ 下，应用启动时会自动配置 PATH、GDAL_DATA、PROJ_LIB 环境变量，无需手动设置。

开发环境

开发调试时，应用默认查找 C:\OSGeo4W 下的 GDAL 安装。如需在开发模式运行，请安装 OSGeo4W 或将 GDAL 添加至系统 PATH。

首次启动

首次启动应用时，会弹出「软件激活」对话框，需完成授权激活后方可使用。详见 授权激活 章节。

激活成功后，主界面顶部的授权状态标签会显示为绿色「永久授权」或蓝色「单次授权」，同时 GDAL 状态标签会显示 GDAL 是否就绪：

• GDAL 已就绪（绿色）：可执行重投影与格式转换
• GDAL 未安装（红色）：仅可导出原始瓦片，无法重投影

卸载

• Windows：通过「控制面板 → 程序与功能」卸载，或运行安装目录下的卸载程序
• macOS：将应用从「Applications」拖入废纸篓
• Linux：使用对应包管理器卸载（dpkg -r、snap remove 等）

数据保留

卸载不会删除用户数据目录（含授权信息）。如需彻底清除，请手动删除以下目录：

• Windows：%APPDATA%/map-download/
• macOS：~/Library/Application Support/map-download/
• Linux：~/.config/map-download/

下一步

• 快速开始 — 五分钟完成首次下载