Skip to content

Latest commit

 

History

History
148 lines (102 loc) · 4.82 KB

readme.md

File metadata and controls

148 lines (102 loc) · 4.82 KB
Raw

Build instructions

Please see .github/workflows/osx_build.yml

files:

  • install.sh
  • notarize-app.sh
  • install_name.py
  • code_sign.py

(NOTE: other files are not used anymore)

On x86_64 MacOS

See install.sh

On Arm64 MacOS

See install.sh

NOTE: there is a bug to create a dmg installer on Apple M1 machine. However, one can do it on a X86_64 machine by copying the build/GeoDa.app.

CodeSign

Please use Developer ID Application: Geodapress LLC (26M5NG43GP) to codesign this app (see developer.apple.com).

  • install_name.py is used to call install_name_tool to use relative path @executable_path/.../Frameworks of all dependent .so files for included dynamic libraries, and then codesign them.

  • code_sign.py is a helper file to automatically codesign the dynamic library (.so) file and its dependent libraries on your machine. You can use it when Xcode reports issues of unsigned dynamic libraries.

Notarization

See notarize-app.sh

Please create a developer account with the permission to do notarization first.

  • xcrun altool --notarize-app to request notarization.
  • xcrun altool --notarization-info to check status.
  • xcrun stapler staple to staple notarization with the dmg file.

OLD INSTRUCTIONS

Build Instructions for GeoDa. Current as of GeoDa 1.8.x

Overview: We assume the build machine hosts a recently-installed clean OS. This build guide contains notes on setting up the compile environment, obtaining the GeoDa source files and dependent libraries, compiling libraries and GeoDa, and finally packaging the program for distribution and installation.

Building GeoDa for 64-bit OSX 10.6.8

NOTE: This is just basic placeholder for now! Not currently complete.

Build machine assumptions:

  • clean OSX 10.6.8 installation with all OS updates.
  • note the current build script will likely only work on OS 10.6.8 and not later versions of OSX. It is very difficult to target previous versions of OSX, so we have chosen to build on the minimum version supported.
  1. Install XCode 3.2
  • this will result in Xcode and all c++ compilers as well as svn being installed.
  1. Use Git to check out GeoDa trunk:

  1. cd to ~/trunk/BuildTools/macosx

  2. run ./build.sh 8 to download and build GeoDa and everything it depends upon.

  • The number 8 should be changed to however many individual cores the build machine has available for parallel compilation.
  1. Package GeoDa for distribution / installation.

Building GeoDa for 64-bit OSX 10.8 or later

  1. Install XCode

  2. Use Git to check out GeoDa trunk:

  1. cd to ~/trunk/BuildTools/macosx

  2. run ./build-express.sh to download prebuild libraries for GeoDa

  3. start GeoDa project using the GeoDa.xcodeproj with Xcode

Building GeoDa plugins for 64-bit OSX

  1. Download Oracle Instant Client Package - Basic & Oracle Instant Client Package - SDK

  2. Unzip SDK, then unzip "Basic", which will be copied to lib/

  3. Create the appropriate libclntsh.dylib link for the version of Instant Client. For example:

    cd ~/instantclient_11_2
ln -s libclntsh.dylib.11.1 libclntsh.dylib

  4. Update ORACLE_HOME

    export ORACLE_HOME=~/instantclient_11_2

  5. Build Oracle plugin

    cd GDAL_HOME/ogr/ogrsf_frmts/oci
make plugin
install_name_tool -change '~/geoda_trunk/BuildTools/macosx/libraries/lib/libgdal.20.dylib' '@executable_path/../Resources/plugins/libgdal.20.dylib' ogr_OCI.so
mv ogr_OCI.so ~/geoda_trunk/BuildTools/macosx/plugins

Building GeoDa plugins for 64-bit OSX

  1. Download File Geodatabase API 1.3 version for Mac 64-bit

  2. Unzip

  3. Update FGDB_HOME

    export FGDB_HOME=~/FileGDB_API

  4. Build FileGDB plugin

    cd GDAL_HOME/ogr/ogrsf_frmts/filegdb
make plugin
nstall_name_tool -change '/Users/xun/geoda_trunk/BuildTools/macosx/libraries/lib/libgdal.20.dylib' '@executable_path/../Resources/plugins/libgdal.20.dylib' ogr_FileGDB.so
mv ogr_FileGDB.so ~/geoda_trunk/BuildTools/macosx/plugins/