Merge pull request #10553 from nextcloud/backport/10516/stable27

[stable27] Document app loading refactor

developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_27.rst

@@ -45,6 +45,11 @@ Added APIs
 * Added a new interface ``\OCP\BackgroundJob\IParallelAwareJob`` that ``\OCP\BackgroundJob\Job`` now implements. It can be used to allow specifying that multiple instances of a job should not be run at the same time. Also added ``\OCP\BackgroundJob\IJobList#hasReservedJob(?string $className = null)`` method to check the condition (`nextcloud/server#37835 <https://github.com/nextcloud/server/pull/37835>`_)
 * New property ``$actionLabel`` has been added to the ``\OCP\Files\Template\TemplateFileCreator`` class with a respective setter ``TemplateFileCreator::setActionLabel`` and getter ``TemplateFileCreator::getActionLabel``.  (`nextcloud/server#37929 <https://github.com/nextcloud/server/pull/37929>`_ + `nextcloud/server#37955 <https://github.com/nextcloud/server/pull/37955>`_)
 * A new interface ``\OCP\Group\Backend\ISearchableGroupBackend`` was added for group backends supporting new method ``searchInGroup`` to search among a group users in an efficient way. (`nextcloud/server#32866 <https://github.com/nextcloud/server/pull/32866>`_)
+* ``\OCP\App\IAppManager`` has the following new methods (`nextcloud/server#36591 <https://github.com/nextcloud/server/pull/36591>`_):
+   * ``loadApp(string $app): void`` Load an app, if not already loaded
+   * ``isAppLoaded(string $app): bool`` Check if an app is loaded
+   * ``loadApps(array $types = []): bool`` Loads all apps. If $types is set to non-empty array, only apps of those types will be loaded.
+   * ``isType(string $app, array $types): bool`` Check if an app is of a specific type
 
 Changed APIs
 ^^^^^^^^^^^^
@@ -59,6 +64,7 @@ Deprecated APIs
 
 * ``\OCP\AppFramework\Utility\ITimeFactory::getTime()`` and ``\OCP\AppFramework\Utility\ITimeFactory::getDateTime()`` were deprecated, because the interface is now a ``\PSR\Clock\ClockInterface`` following the `PSR-20standard <https://www.php-fig.org/psr/psr-20/#21-clockinterface>`_. (`nextcloud/server#35872 <https://github.com/nextcloud/server/pull/35872>`_)
 * ``\OCP\GroupInterface::usersInGroup()`` is deprecated in favor of newly added ``\OCP\Group\Backend\ISearchableGroupBackend`` interface. (`nextcloud/server#32866 <https://github.com/nextcloud/server/pull/32866>`_)
+* In ``\OC_App``, the following methods are deprecated: ``isAppLoaded``, ``loadApp``, ``isType``. Use the new methods from ``\OCP\App\IAppManager`` instead (`nextcloud/server#36591 <https://github.com/nextcloud/server/pull/36591>`_).
 
 Removed APIs
 ^^^^^^^^^^^^