Установка GeoDjango

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 (из модуля Python ctypes.util) для обнаружения библиотек. Процедура find_library использует программу objdump (часть пакета binutils) для проверки общей библиотеки в системах GNU/Linux. Таким образом, если binutils не установлен на вашей системе Linux, Python's ctypes может не найти вашу библиотеку, даже если путь к библиотеке настроен правильно, и геопространственные библиотеки были скомпилированы идеально.

Пакет binutils можно установить в системах Debian и Ubuntu с помощью следующей команды:

$ sudo apt-get install binutils

Аналогично, в системах Red Hat и CentOS:

$ sudo yum install binutils

Python

Хотя macOS поставляется с установленным Python, пользователи могут использовать инсталляторы фреймворка, предоставляемые Python Software Foundation. Преимущество использования инсталлятора заключается в том, что Python macOS останется «нетронутым» для внутреннего использования операционной системой.

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

Postgres.app

Postgres.app — это автономный сервер PostgreSQL, включающий расширение PostGIS. Вам также потребуется установить gdal и libgeoip с помощью Homebrew.

После установки Postgres.app добавьте следующее в ваш .bash_profile, чтобы вы могли запускать программы пакета из командной строки. Замените X.Y на версию PostgreSQL в установленной Postgres.app:

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

Вы можете проверить, правильно ли настроен путь, набрав which psql в командной строке.

Homebrew

Homebrew предоставляет «рецепты» для создания бинарных файлов и пакетов из исходного кода. Он предоставляет рецепты для предварительных требований GeoDjango на компьютерах Macintosh, работающих под управлением macOS. Поскольку Homebrew по-прежнему собирает программное обеспечение из исходного кода, требуется Xcode.

Резюме:

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

MacPorts

MacPorts может использоваться для установки необходимых компонентов GeoDjango на компьютерах под управлением macOS. Поскольку MacPorts по-прежнему собирает программное обеспечение из исходного кода, требуется Xcode.

Резюме:

$ sudo port install postgresql14-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/postgresql14/bin

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

Python

Установите 64-битную версию Python. Для получения дополнительной информации см. Установку Python.

PostgreSQL

Загрузите последний инсталлятор PostgreSQL 15.x с веб-сайта EnterpriseDB. После загрузки запустите инсталлятор, следуйте инструкциям на экране и оставляйте значения по умолчанию, если вы не понимаете последствий их изменения.

По завершении установки инсталлятор спросит: «Запустить Stack Builder при выходе?», оставьте эту опцию отмеченной, так как она необходима для установки PostGIS.

PostGIS

Внутри Stack Builder (чтобы запустить вне инсталлятора, выберите «Пуск ‣ PostgreSQL 15 ‣ Application Stack Builder»), выберите PostgreSQL 15 (x64) на порту 5432 в раскрывающемся списке и нажмите «Далее». Разверните меню Категории ‣ Расширения пространственных данных и выберите PostGIS X.Y для PostgreSQL 15.

После нажатия «Далее» вас попросят подтвердить выбранный пакет и «Директорию загрузки». Нажмите «Далее» ещё раз, это позволит загрузить PostGIS, и вас попросят нажать «Далее», чтобы начать установку PostGIS. Во время установки выберите значения по умолчанию. Процесс установки включает в себя четыре диалоговых окна «Да/Нет», значение по умолчанию для всех четырёх — «Нет».

OSGeo4W

Инсталлятор OSGeo4W помогает установить библиотеки PROJ, GDAL и GEOS, необходимые для GeoDjango. Сначала загрузите инсталлятор OSGeo4W и запустите его. Выберите Установить веб-GIS Express и нажмите «Далее». В списке «Выбрать пакеты» убедитесь, что 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

Модуль Python psycopg предоставляет интерфейс между Python и базой данных PostgreSQL. psycopg можно установить через pip в вашей виртуальной среде Python:

...\> py -m pip install psycopg

Примечания