You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_32.rst
+58-44Lines changed: 58 additions & 44 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,7 +5,9 @@ Upgrade to Nextcloud 32
5
5
General
6
6
-------
7
7
8
-
- A new ``tests/autoload.php`` file was added to server repository, that you can include in your app ``bootstrap.php`` file for tests, to be able to load the core ``\Test\TestCase`` class. You should remove any call to ``\OC::$loader`` in your code as this legacy loader is being removed. This new file is backported to branches stable31, stable30 and stable29, so if your application supports multiple Nextcloud major versions it should still work.
8
+
- A new ``tests/autoload.php`` file was added to server repository, that you can include in your app ``bootstrap.php`` file for tests, to be able to load the core ``\Test\TestCase`` class.
9
+
You should remove any call to ``\OC::$loader`` in your code as this legacy loader is being removed.
10
+
This new file is backported to branches stable31, stable30 and stable29, so if your application supports multiple Nextcloud major versions it should still work.
9
11
10
12
Front-end changes
11
13
-----------------
@@ -55,28 +57,39 @@ Added APIs
55
57
^^^^^^^^^^
56
58
57
59
- New ``OCP\ContextChat`` API. See :ref:`context_chat` for details.
58
-
- New task processing task type ``OCP\TaskProcessing\TextToSpeech`` to convert text to speech.
59
-
- New interface ``\OCP\Share\IShareProviderSupportsAllSharesInFolder`` extending ``\OCP\Share\IShareProvider`` to add the method ``\OCP\Share\IShareProviderSupportsAllSharesInFolder::getAllSharesInFolder`` used for querying all shares in a folder without filtering by user.
60
-
- New method ``\OCP\IUser::canChangeEmail`` allowing to check if the user backend allows the user to change their email address.
61
-
- New method ``\OCP\Files\IFilenameValidator::sanitizeFilename`` allowing to sanitize a given filename to comply with configured constraints.
62
-
- New service ``\OCP\Template\ITemplateManager`` to access template related functions, and get instances of new interface ``\OCP\Template\ITemplate`` instead of building manually ``\OCP\Template``.
60
+
- New interface ``\OCP\OCM\ICapabilityAwareOCMProvider`` to extend the OCM provider with 1.1 and 1.2 extensions of the Open Cloud Mesh Discovery API
61
+
- New interface ``\OCP\Search\IExternalProvider`` allows extending the search provider with an explicit flag
62
+
to indicate that the search is performed on external (3rd-party) resources.
63
+
This is used in Unified Search to disable searches through these by default (via a toggle switch).
64
+
- New interface ``\OCP\Share\IShareProviderSupportsAllSharesInFolder`` extending ``\OCP\Share\IShareProvider``
65
+
to add the method ``\OCP\Share\IShareProviderSupportsAllSharesInFolder::getAllSharesInFolder`` used for querying all shares in a folder without filtering by user.
66
+
- New interface ``\OCP\Notification\IPreloadableNotifier`` to allow notifier implementations to preload
67
+
and cache data for many notifications at once to improve performance by, for example, bundling SQL queries.
68
+
- New interface ``\OCP\Template\ITemplateManager`` to access template related functions,
69
+
and get instances of new interface ``\OCP\Template\ITemplate`` instead of building manually ``\OCP\Template``.
70
+
- New attribute ``\OCP\AppFramework\Http\Attribute\RequestHeader`` used for documenting request headers for OpenAPI specifications generated using openapi-extractor.
63
71
- New event ``\OCP\Files\Config\Event\UserMountAddedEvent`` which is emitted when new mount is added to the ``oc_mounts`` table.
64
72
- New event ``\OCP\Files\Config\Event\UserMountRemovedEvent`` which is emitted when an existing mount is removed from the ``oc_mounts`` table.
65
73
- New event ``\OCP\Files\Config\Event\UserMountUpdatedEvent`` which is emitted when an existing mount is updated in the ``oc_mounts`` table.
66
-
- New attribute ``\OCP\AppFramework\Http\Attribute\RequestHeader`` used for documenting request headers for OpenAPI specifications generated using openapi-extractor.
74
+
- New method ``\OCA\Files\Controller\TemplateController::listTemplateFields`` to list the fields of a template,
75
+
accessible at ``/ocs/v2.php/apps/files/api/v1/templates/fields/{fileId}``.
76
+
- New method ``\OCP\Files\IFilenameValidator::sanitizeFilename`` allowing to sanitize a given filename to comply with configured constraints.
67
77
- New method ``\OCP\Files\Template\ITemplateManager::listTemplateFields`` to allow listing the fields of a template.
68
-
- New method ``\OCA\Files\Controller\TemplateController::listTemplateFields`` to list the fields of a template, accessible at ``/ocs/v2.php/apps/files/api/v1/templates/fields/{fileId}``.
69
78
- New method ``\OCP\Files\Template\BeforeGetTemplatesEvent::shouldGetFields`` to get the event's ``withFields`` property, which should determine whether or not to perform template field extraction on the returned templates.
70
-
- New interface ``\OCP\OCM\ICapabilityAwareOCMProvider`` to extend the OCM provider with 1.1 and 1.2 extensions of the Open Cloud Mesh Discovery API
71
-
- New task processing task type ``OCP\TaskProcessing\AnalyzeImages`` to ask questions about images.
72
-
- New interface ``\OCP\Search\IExternalProvider`` allows extending the search provider with an explicit flag to indicate that the search is performed on external (3rd-party) resources. This is used in Unified Search to disable searches through these by default (via a toggle switch).
73
-
- New interface ``\OCP\Notification\IPreloadableNotifier`` to allow notifier implementations to preload and cache data for many notifications at once to improve performance by, for example, bundling SQL queries.
79
+
- New method ``\OCP\IUser::canChangeEmail`` allowing to check if the user backend allows the user to change their email address.
80
+
- New method ``\OCP\IDateTimeZone::getDefaultTimezone`` allowing to get the default timezone configured for Nextcloud.
81
+
- Task processing API:
82
+
83
+
- New task processing task type ``OCP\TaskProcessing\TextToSpeech`` to convert text to speech.
84
+
- New task processing task type ``OCP\TaskProcessing\AnalyzeImages`` to ask questions about images.
85
+
74
86
75
87
Changed APIs
76
88
^^^^^^^^^^^^
77
89
78
90
- ``\OCP\Authentication\TwoFactorAuth\ILoginSetupProvider::getBody``, ``\OCP\Authentication\TwoFactorAuth\IPersonalProviderSettings::getBody`` and ``\OCP\Authentication\TwoFactorAuth\IProvider::getBody`` return type was broaden from ``\OCP\Template`` class to ``\OCP\Template\ITemplate`` interface. Should not change anything for applications.
79
91
- ``\OCP\Files\Template\BeforeGetTemplatesEvent`` now takes an optional boolean constructor value, ``withFields``, that allows you to explicitly control whether template fields should be extracted. The default value is ``false``.
92
+
- ``\OCP\IDateTimeZone::getTimezone`` now has a new optional string parameter ``userId`` allowing to request the timezone of another user than the current.
80
93
81
94
Deprecated APIs
82
95
^^^^^^^^^^^^^^^
@@ -121,35 +134,36 @@ Removed APIs
121
134
- Template function ``vendor_script`` was unused and removed
122
135
- The support for ``app.php`` files, deprecated since Nextcloud 19, was removed. Existence of the file is still checked to show an error if present, but that will be removed in a later version. Please move to ``OCP\AppFramework\Bootstrap\IBoostrap`` instead.
123
136
- The following getters, deprecated since 20, were removed. Please use Dependency Injection or ``\OCP\Server::get`` instead:
0 commit comments