spksrc

spksrc is a cross compilation framework intended to compile and package software for Synology NAS devices. Packages are made available via the SynoCommunity repository_.

Contributing

Before opening a new issue, check the FAQ_ and search open issues. If you can't find an answer, or if you want to open a package request, read CONTRIBUTING_ to make sure you include all the information needed for contributors to handle your request.

Setup Development Environment

Docker ^^^^^^

• Fork and clone spksrc: git clone https://[email protected]/You/spksrc.git ~/spksrc
• Install Docker on your host OS: Docker installation. A wget-based alternative for linux: Install Docker with wget.
• Download the spksrc docker container: docker pull synocommunity/spksrc
• Run the container with docker run -it -v ~/spksrc:/spksrc synocommunity/spksrc /bin/bash

Virtual machine ^^^^^^^^^^^^^^^ A virtual machine based on an 64-bit version of Debian stable OS is recommended. Non-x86 architectures are not supported.

• Install the requirements::

  sudo dpkg --add-architecture i386 && sudo apt-get update sudo aptitude install build-essential debootstrap python-pip automake libgmp3-dev libltdl-dev libunistring-dev libffi-dev libcppunit-dev ncurses-dev imagemagick libssl-dev pkg-config zlib1g-dev gettext git curl subversion check intltool gperf flex bison xmlto php5 expect libgc-dev mercurial cython lzip cmake swig libc6-i386 libmount-dev libpcre3-dev libbz2-dev sudo pip install -U setuptools pip wheel httpie

• You may need to install some packages from testing like autoconf. Read about Apt-Pinning to know how to do that.

• Some older toolchains may require 32-bit development versions of packages, e.g. zlib1g-dev:i386

Usage

Once you have a development environment set up, you can start building packages, create new ones, or improve upon existing packages while making your changes available to other people. See the Developers HOW TO_ for information on how to use spksrc.

Donate

To support SynoCommunity, you can make a donation to its founder

.. image:: https://www.paypal.com/en_US/i/btn/btn_donate_LG.gif :target: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=F6GDE5APQ4SBN

License

When not explicitly set, files are placed under a 3 clause BSD license_

.. _3 clause BSD license: http://www.opensource.org/licenses/BSD-3-Clause .. _bug tracker: https://github.com/SynoCommunity/spksrc/issues .. _CONTRIBUTING: https://github.com/SynoCommunity/spksrc/blob/master/CONTRIBUTING.md .. _Developers HOW TO: https://github.com/SynoCommunity/spksrc/wiki/Developers-HOW-TO .. _Docker installation: https://docs.docker.com/engine/installation .. _FAQ: https://github.com/SynoCommunity/spksrc/wiki/Frequently-Asked-Questions .. _Install Docker with wget: https://docs.docker.com/linux/step_one .. _SynoCommunity repository: http://www.synocommunity.com