From c46d127a6d188ee2b4871e74a954633b29c4fb24 Mon Sep 17 00:00:00 2001 From: Vincent Petry Date: Mon, 26 Oct 2020 10:44:03 +0100 Subject: [PATCH] Mention cloning shipped apps in dev env Add mention to cloning external shipped apps into the apps folder in the development environment, to be able to test upgrades as these apps will be required at that point. Signed-off-by: Vincent Petry --- developer_manual/getting_started/devenv.rst | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/developer_manual/getting_started/devenv.rst b/developer_manual/getting_started/devenv.rst index d2bce7bd5..6c32a1263 100644 --- a/developer_manual/getting_started/devenv.rst +++ b/developer_manual/getting_started/devenv.rst @@ -87,6 +87,23 @@ or:: Now access the installation at http://localhost/ (or the corresponding URL) in your web browser to set up your instance. +Check out external shipped apps +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +This optional step is especially necessary if you want to test upgrading, as the following apps are required to be present during an upgrade. + +Install the viewer app:: + + cd /var/www/apps + git clone https://github.com/nextcloud/viewer.git + +Make sure to use a version compatible with the server by checking out the matching tag. +You can check the ``appinfo/info.xml`` of the app to see if its ``min-version`` field is compatible with the current server. + +When upgrading the server code you might need to upgrade the app code as well before running ``occ upgrade``. + +.. note:: The same applies to all the apps listed under ``alwaysEnabled`` in `shipped.json `_ but most are already present in the server repository. + Enabling debug mode ^^^^^^^^^^^^^^^^^^^