Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat(developer): Copy over changes for developers from GitHub issue #10414

Merged
merged 3 commits into from
May 22, 2023
Merged

feat(developer): Copy over changes for developers from GitHub issue #10414

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
7063d82
feat(developer): Copy over changes for developers from GitHub issue
nickvergessen May 22, 2023
1ee6241
fix(developer): Fix duplicate "is now a"
nickvergessen May 22, 2023
a862fdf
fix(developer): Adjust link to match the pattern
nickvergessen May 22, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
45 changes: 34 additions & 11 deletions developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_27.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,16 +16,22 @@ Make sure your ``appinfo/info.xml`` allows for Nextcloud 27.
.. code-block:: xml

<dependencies>
<nextcloud min-version="23" max-version="27" />
<nextcloud min-version="25" max-version="27" />
</dependencies>

Front-end changes
-----------------

Removed APIs
^^^^^^^^^^^^
Added APIs
^^^^^^^^^^

* A new Files Router API allows you to control the files router service and update views, querys or param without page reload (`nextcloud/server#37824 <https://github.com/nextcloud/server/pull/37824>`_)

* tbd
.. code-block:: js

// https://github.com/nextcloud/server/blob/master/apps/files/src/services/RouterService.ts
OCP.Files.Router.goTo('/trashbin?dir=/Unsplash.d1680193199')
OCP.Files.Router.goToRoute('fileslist', { view: 'files' }, { dir: '/Folders/Group folder' })

Back-end changes
----------------
Expand All @@ -38,19 +44,36 @@ Nextcloud 27 no longer loads classes in the deprecated :ref:`PSR-0 naming standa
Added APIs
^^^^^^^^^^

* tbd

Changed APIs
^^^^^^^^^^^^
* ``\OCP\AppFramework\Utility\ITimeFactory`` is now a ``\PSR\Clock\ClockInterface`` following the `PSR-20 standard <https://www.php-fig.org/psr/psr-20/#21-clockinterface>`_. (`nextcloud/server#35872 <https://github.com/nextcloud/server/pull/35872>`_)
* ``\OCP\Accounts\IAccountManager::PROPERTY_DISPLAYNAME_LEGACY`` was added to keep the provisioning API compatible. (`nextcloud/server#36665 <https://github.com/nextcloud/server/pull/36665>`_)
* A new system config ``ratelimit.protection.enabled`` (boolean, default true) was added to allow developers to **disable** rate limiting. It is **not** recommended to disable this on a production/live system. (`nextcloud/server#37542 <https://github.com/nextcloud/server/pull/37542>`_)
* A new OCP API under ``\OCP\SpeechToText`` was introduced to allow automatic transcription of media (`nextcloud/server#37674 <https://github.com/nextcloud/server/pull/37674>`_)
* 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>`_)

* tbd

Deprecated APIs
^^^^^^^^^^^^^^^

* tbd
* ``\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>`_)

Removed APIs
^^^^^^^^^^^^

* tbd
* Intermediate transition event classes ``\OCP\WorkflowEngine\IEntityCompat`` and ``\OCP\WorkflowEngine\IOperationCompat`` have been removed as advertised for 2023 (`nextcloud/server#37040 <https://github.com/nextcloud/server/pull/37040>`_)


Behavioral changes
^^^^^^^^^^^^^^^^^^

* ``\OCP\Files\Cache\CacheEntryRemovedEvent`` will now be dispatched for all files and folders inside the deleted node. (`nextcloud/server#34773 <https://github.com/nextcloud/server/pull/34773>`_)

Client APIs
-----------

Changed APIs
^^^^^^^^^^^^

* The OCS translation API was extended to return the ``from`` language attribute so in case no from was given, clients can afterwards show in the UI which language was detected and used for translating. (`nextcloud/server#38003 <https://github.com/nextcloud/server/pull/38003>`_)