Documentation on how developers on Windows or macOS can contribute
I can’t seem to find any at https://docs.nextcloud.com/server/9/developer_manual/general/devenv.html
What do we recommend? At events (such as Ladies that FOSS) this really is an issue, as we can not assume everyone having Linux installed. Recently I had more and more people with Windows and OS X asking me how to best set up a dev environment.
- For Windows there was talk about Vagrant or a VM, and we also needed to resort to Ubuntu live USB. What’s the best solution we can advertise?
- For OS X, what are you using @karlitschek @LukasReschke @MorrisJobke @eppfel @nextcloud/mac?
I use docker with this docker file: https://github.com/georgehrke/docker-webdev-php (on OS X)
@MorrisJobke Helped me to set it up at the conference and I tried to document it. But then there were changes in the PHP packages, that enforced using a custom Apache installation. I did get it to work, but I did not finish the documentation: https://pad.epp.cloud/s/B1vqv1fMe
Basically I use Homebrew to install: PHP5.6 and PHP7 with apache (and mysql).
I tried using docker, but got frustrated...
Basically: https://pad.morrisjobke.de/p/osx-dev
@MorrisJobke @eppfel so do we want to put both our documents in the documentation? I guess in https://github.com/nextcloud/documentation/tree/master/developer_manual/general as devenv-windows.rst and devenv-macos.rst ?
Ok, I'll finish the documentation for macOS, then. But would be nice to have a documentation for the docker image as well.
No, devs on windows? Can someone of you guys mention anyone directly?
@eppfel I actually sat together with @julieannenoying the other day to set up her development environment. After around 8 hours of hacking & searching, this is the developer documentation for Windows :)
I added the quickstart by Martin Stadler @xMartin to my documentation draft, which is still incomplete, because it needs a test on a clean Mac.
Feel free to edit/correct the documentation by logging in with github:
https://pad.epp.cloud/s/B1vqv1fMe
git clone [email protected]:nextcloud/server.git
cd server
git submodule update --init
php -S localhost:8080
worked for me on a fresh Mac with macOS Sierra (PHP 5.6.28). It wouldn't work on an older version.
thx, @xMartin I could not find the bundled php version for Sierra. 😁