Cross compilation framework to create native packages for the Western Digital NAS
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
tests
wdpk
.dockerignore
.gitignore
Dockerfile
LICENSE
README.rst
build_and_install.sh
mksapkg

README.rst

wdpksrc

This project contains the source and tools for software packages for Western Digital My Cloud (OS3) NAS devices. The packages are made available via the WDCommunity website. Most of the packages are simply scripts to fetch the applications from the official sources and configure them with a sensible default. Only a few packages were compiled with the OS3 toolchain with the help of the SynoCommunity project tools.

Most of the packages are published on the WD community forum in their own thread. Use the search bar.

Setup Development Environment

mksapkg setup

For simple script based apps (most of the current packages), you only need mksapkg to create a binary.

On Ubuntu 16.04:

apt-get install libxml2:i386

Ensure you have openssl v1.0.x, not openssl v1.1+ (as is the case on Ubuntu 18).

Docker

The build environment is also available in a docker image.

docker build -t wdpk .
docker run -it -v $(pwd):/wdpksrc wdpk /bin/bash
cd wdpk/<somepackage>
./build.sh

Build and deploy test

./build_and_install.sh  <package>  <host>

This will build the package, install it on a PR4100 host device and run a sanity check if a test is available.

Native apps

If you want to compile native apps, you'll need a complete wdpksrc / spksrc toolchain. Then follow the

Currently, these custom WD targets are available in this SynoCommunity fork

  • wdx64 - WD PR2100/PR4100/DL2100/DL4100
  • wdpro - WD PR2100 / PR4100 with 4.1.9 kernel
  • wddl - WD DL2100 / DL4100 with 3.10.28 kernel
  • wdarm - all other devices (firmware version 2.x only!)

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.

Note that spksrc creates synology SPK packages.

  • rename the .spk package with the .tar extension
  • unpack with tar xf somepackage.tar
  • move the bins and libs to your wdpk somepackage
  • modify the start/stop scripts as necessary into the wdpk format, stripped from all synology specific logics.

Donate

Feel free to donate to the SynoCommunity project.

License

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