LD_LIBRARY_PATH 环境变量¶

用户可以设置此环境变量来自定义他们要使用的库路径。从源代码构建的软件的典型库目录是/usr/local/lib。因此，需要将/usr/local/lib包含在LD_LIBRARY_PATH变量中。例如，用户可以在他们的 bash 配置文件中添加以下内容：

export LD_LIBRARY_PATH=/usr/local/lib

设置系统库路径¶

在 GNU/Linux 系统上，通常在/etc/ld.so.conf中有一个文件，其中可能包含来自另一个目录（例如/etc/ld.so.conf.d）中文件的其他路径。以 root 用户身份，在新的一行中将自定义库路径（如/usr/local/lib）添加到ld.so.conf中。这是一个示例操作方法：

$ sudo echo /usr/local/lib >> /etc/ld.so.conf
$ sudo ldconfig

对于 OpenSolaris 用户，可以使用crle实用程序修改系统库路径。运行不带任何选项的crle以查看当前配置，并使用crle -l设置新的库路径。修改系统库路径时要非常小心。

# crle -l $OLD_PATH:/usr/local/lib

安装binutils¶

GeoDjango 使用find_library函数（来自ctypes.util Python 模块）来查找库。find_library例程使用名为objdump（binutils软件包的一部分）的程序来验证 GNU/Linux 系统上的共享库。因此，如果您的 Linux 系统上没有安装binutils，即使您的库路径设置正确并且地理空间库构建完美，Python 的 ctypes 也可能无法找到您的库。

可以使用以下命令在 Debian 和 Ubuntu 系统上安装binutils软件包：

$ sudo apt-get install binutils

同样，在 Red Hat 和 CentOS 系统上：

$ sudo yum install binutils

Python¶

尽管 macOS 自带 Python，但用户可以使用 Python 软件基金会提供的框架安装程序。使用安装程序的一个优点是，macOS 的 Python 将保持“原始状态”，用于内部操作系统使用。

export PATH=/Library/Frameworks/Python.framework/Versions/Current/bin:$PATH

Postgres.app¶

Postgres.app 是一个独立的 PostgreSQL 服务器，其中包含 PostGIS 扩展。您还需要使用Homebrew安装gdal和libgeoip。

安装 Postgres.app 后，将以下内容添加到您的.bash_profile中，以便您可以从命令行运行软件包的程序。将X.Y替换为您安装的 Postgres.app 中的 PostgreSQL 版本：

export PATH=$PATH:/Applications/Postgres.app/Contents/Versions/X.Y/bin

您可以在终端提示符下键入which psql来检查路径是否设置正确。

Homebrew¶

Homebrew 提供了用于从源代码构建二进制文件和软件包的“配方”。它为运行 macOS 的 Macintosh 电脑上的 GeoDjango 先决条件提供了配方。因为 Homebrew 仍然从源代码构建软件，所以需要 Xcode。

摘要

$ brew install postgresql
$ brew install postgis
$ brew install gdal
$ brew install libgeoip

MacPorts¶

可以使用 MacPorts 在运行 macOS 的计算机上安装 GeoDjango 先决条件。因为 MacPorts 仍然从源代码构建软件，所以需要 Xcode。

摘要

$ sudo port install postgresql13-server
$ sudo port install geos
$ sudo port install proj6
$ sudo port install postgis3
$ sudo port install gdal
$ sudo port install libgeoip

export PATH=/opt/local/bin:/opt/local/lib/postgresql13/bin

export DYLD_FALLBACK_LIBRARY_PATH=/opt/local/lib:/opt/local/lib/postgresql13

Python¶

安装 64 位版本的 Python。有关更多信息，请参见 安装 Python。

PostgreSQL¶

从 EnterpriseDB 网站下载最新的 PostgreSQL 15.x 安装程序。下载后，运行安装程序，按照屏幕上的说明操作，并保留默认选项，除非您了解更改这些选项的后果。

安装程序完成后，它会询问“退出时启动 Stack Builder？”——请保持选中状态，因为这对于安装 PostGIS 是必要的。

PostGIS¶

在堆栈构建器中（要在安装程序外部运行，请执行 开始 ‣ PostgreSQL 15 ‣ 应用程序堆栈构建器），从下拉菜单中选择 PostgreSQL 15 (x64) on port 5432，然后单击下一步。展开 类别 ‣ 空间扩展 菜单树，然后选择 PostGIS X.Y for PostgreSQL 15。

单击下一步后，系统会提示您确认所选软件包和“下载目录”。再次单击下一步，这将下载 PostGIS，然后系统会要求您单击下一步以开始 PostGIS 安装程序。在安装过程中选择默认选项。安装过程包括四个“是/否”对话框，所有四个对话框的默认选项均为“否”。

OSGeo4W¶

OSGeo4W 安装程序 有助于安装 GeoDjango 所需的 PROJ、GDAL 和 GEOS 库。首先，下载 OSGeo4W 安装程序 并运行它。选择 Express Web-GIS Install 并单击下一步。在“选择软件包”列表中，确保选中 GDAL。如果默认情况下启用了任何其他软件包，则 GeoDjango 不需要这些软件包，可以安全地取消选中。单击下一步并接受许可协议后，软件包将自动下载并安装，之后您可以退出安装程序。

修改 Windows 环境¶

为了使用 GeoDjango，您需要将 OSGeo4W 目录添加到 Windows 系统 Path，并创建 GDAL_DATA 和 PROJ_LIB 环境变量。可以使用 cmd.exe 执行以下命令集来进行设置。完成后重新启动设备，以便识别新的环境变量。

set OSGEO4W_ROOT=C:\OSGeo4W
set GDAL_DATA=%OSGEO4W_ROOT%\apps\gdal\share\gdal
set PROJ_LIB=%OSGEO4W_ROOT%\share\proj
set PATH=%PATH%;%OSGEO4W_ROOT%\bin
reg ADD "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v Path /t REG_EXPAND_SZ /f /d "%PATH%"
reg ADD "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v GDAL_DATA /t REG_EXPAND_SZ /f /d "%GDAL_DATA%"
reg ADD "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v PROJ_LIB /t REG_EXPAND_SZ /f /d "%PROJ_LIB%"

安装 Django 并设置数据库¶

在您的系统上 安装 Django。建议您为创建的每个项目创建一个 虚拟环境。

psycopg¶

psycopg Python 模块提供了 Python 和 PostgreSQL 数据库之间的接口。psycopg 可以通过 pip 在您的 Python 虚拟环境中安装。

...\> py -m pip install psycopg

脚注