documentation icon indicating copy to clipboard operation
documentation copied to clipboard

Documentation on how developers on Windows or macOS can contribute

Open jancborchardt opened this issue 9 years ago • 9 comments

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?

jancborchardt avatar Nov 22 '16 15:11 jancborchardt

I use docker with this docker file: https://github.com/georgehrke/docker-webdev-php (on OS X)

georgehrke avatar Nov 22 '16 15:11 georgehrke

@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...

eppfel avatar Nov 22 '16 15:11 eppfel

Basically: https://pad.morrisjobke.de/p/osx-dev

MorrisJobke avatar Nov 25 '16 23:11 MorrisJobke

@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 ?

jancborchardt avatar Dec 05 '16 13:12 jancborchardt

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 avatar Dec 05 '16 16:12 eppfel

@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 :)

jancborchardt avatar Dec 05 '16 19:12 jancborchardt

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

eppfel avatar Mar 27 '17 12:03 eppfel

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.

xMartin avatar Mar 27 '17 13:03 xMartin

thx, @xMartin I could not find the bundled php version for Sierra. 😁

eppfel avatar Mar 27 '17 13:03 eppfel