Developer setup

Getting setup for development

The development environment has only been test on Ubuntu 20.04 and Mac OS X. The development environment does require an x86 processor.

Installing dependencies

Ubuntu
Mac OS X
Ubuntu
apt-get install -y git make docker.io gcc g++ \
libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev
Mac OS X
# install brew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# install dependancies
brew install #fill in the blanks here

Configuring Docker

Ubuntu
Mac OS X
Ubuntu
usermod -G sudo,docker $USER
systemctl enable docker
systemctl start docker
Mac OS X

Install docker desktop from:

https://www.docker.com/products/docker-desktop

Installing Golang

Ubuntu
Mac OS X
Ubuntu
wget https://golang.org/dl/go1.15.6.linux-amd64.tar.gz
tar -C /usr/local -xzf go1.15.6.linux-amd64.tar.gz
echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.profile
source ~/.profile
Mac OS X
brew install go

Install gocv

Ubuntu
Mac OS X
Ubuntu
go get -u -d gocv.io/x/gocv
cd $GOPATH/src/gocv.io/x/gocv
make install
Mac OS X
git clone https://gitlab.com/skyhuborg/get-started.git
cd get-started/devsetup/macos
brew install --build-from-source ./opencv.rb

Checkout out the code

$ git clone --recurse-submodules -b develop \
[email protected]:skyhuborg/tracker.git

The develop branch has all of our latest code, master is reserved for stable releases.

If you get a permissions error, you may need to add a public key to gitlab. Generate it using ssh-keygen:

ssh-keygen -t rsa -b 2048 -C "[email protected]"

Copy your new key from the file you stored it in (probably ~/.ssh/id_rsa.pub) over into your gitlab account. It's also possible you may need to run the git clone command from an ssh shell opened at gitlab:

git clone --recurse-submodules -b develop \
[email protected]:skyhuborg/tracker.git

See the gitlab documentation for this process if you still need help at https://docs.gitlab.com/ee/ssh/

Once you've checked out the code, you're ready to build.

This assumes you are in the root of the git repository.

make

Now you've successfully built the project, lets move on to configuring vscode to launch the Full Development Stack.