Changes for developers & admins for Nextcloud 25

[nickvergessen]

Continuation of #29914

Front-end

• Theming redone: [stable25] New theming, how to make your app compatible #32060
• body.theme--dark classes removed. See above
• SCSS support removed! ⚠️ [stable25] New theming, how to make your app compatible #32060
  https://help.nextcloud.com/t/scss-support-dropped-with-nextcloud-25/
• Files app ID changes in the DOM, to remove duplicate IDs for accessibility:
  • Replace files app ids to classes #33320 (comment)
  • Remove legacy #dir element in files list #33373
  • Remove more legacy ids #33379
• Non-Vue dialogs will stop working if triggered on top of Vue dialogs because of focus trap, example here: Port password confirmation dialog to vue #33675.
• We changed the container layout to adapt to the design changes with Nextcloud 25
  • The body is no longer the main scroll area but instead the app content
  • ⚗️ Proof of concept: Redesign app-content #33568
  • Scroll listeners need to be adapted to watch for the scroll on the NcAppContent container instead of the main document
  • If you are using sticky headers in your app you might need to adjust the css top property as the app content container is now the scrollable element. For any contained sticky that had a header height top spacing before you should be able to set that to 0
  • If @nextcloud/vue components are used you'll need to update to the major release 7 of the library
    • Migration help for that can be found in https://github.com/nextcloud/nextcloud-vue/blob/master/CHANGELOG.md#v700-beta0-2022-09-01
    • v6.0.0 included a rename of the components to be prefixed with Nc which is something that would also be required if not already done
• A global option to disable keyboard shortcuts was added to the accessibility settings. Since it heavily depends on the screenreader and tools that you use if Ctrl and/or Alt or other things are okay to use or not and maintaining a more detailed list is too much effort, we went for a global on/off switch. Apps can use this public javascript API call to determine whether the user used the opt-out: OCP.Accessibility.disableKeyboardShortcuts(). If that is the case, no additional shortcuts shall be registered by any app. Only space to toggle checkboxes and enter to submit the currently active buttons/links are okay: Add global setting to disable keyboad shortcuts #34081

Backend

• The christophwurst/nextcloud composer package was replaced with a now Nextcloud owned nextcloud/ocp package. The content is the same and all older versions were generated, so you can transition right away no matter which versions you support. We also have a GitHub Actions cron job template available at https://github.com/nextcloud/.github/blob/master/workflow-templates/update-nextcloud-ocp.yml which updates the packages every sunday, so you can make sure your app is still compatible with the latest OCP.
• CSP policies now have merge priority: true wins over false: Add CSP policy merge priority for booleans #32113
• IShareProvider::getSharesInFolder now has a new argument $shallow to support shallow and deep searches of shares in a folder. Update owner of subdir on move into/out of share #31728
• Use IUserManager::getDisplayName(): ?string when you only want the display name of the user. This will avoid fetching all the user properties and generating useless DB/LDAP queries
• Use \OCP\Server::get(className) instead of the private \OC::$server->get when dependency injection is not possible.
• Dashboard widgets are soon displayed in the mobile clients. With Extend dashboard api to allow listing of widgets #33658 buttons to see more information can be added and you can now already implement your widget as an OCP\Dashboard\IAPIWidget so the data is available to the clients. Also check the new documentation https://docs.nextcloud.com/server/latest/developer_manual/digging_deeper/dashboard.html
• ICreateFromString::handleIMipMessage(string $name, string $calendarData) must be supported

Removed from public namespace:

• …

Removed from private namespace:

• …

Deprecations

• …

Deprecations of Events & Hooks

• Deprecate \OCP\Collaboration\Resources::loadAdditionalScripts Add event to load additional scripts for projects #32349

Behavorial changes

• …

Changes for admins

• Remove deprecated occ app:check-code command #32210
• …

[susnux]

Probably #33320 should be mentioned, I know some applications relying on those ids

[nickvergessen]

Added:

Backend

• Dashboard widgets are soon displayed in the mobile clients. With Extend dashboard api to allow listing of widgets #33658 buttons to see more information can be added and you can now already implement your widget as an OCP\Dashboard\IAPIWidget so the data is available to the clients

[nickvergessen]

Added:

Frontend

• A global option to disable keyboard shortcuts was added to the accessibility settings. Since it heavily depends on the screenreader and tools that you use if Ctrl and/or Alt or other things are okay to use or not and maintaining a more detailed list is too much effort, we went for a global on/off switch. Apps can use this public javascript API call to determine whether the user used the opt-out: OCP.Accessibility.disableKeyboardShortcuts(). If that is the case, no additional shortcuts shall be registered by any app. Only space to toggle checkboxes and enter to submit the currently active buttons/links are okay: Add global setting to disable keyboad shortcuts #34081

[ArtificialOwl]

<default_enable/> within info.xml will not work anymore. The listing of app enabled by default during installation of Nextcloud is now done within core/shipped.json, using key defaultEnabled

[nickvergessen]

Added:

Backend

• The christophwurst/nextcloud composer package was replaced with a now Nextcloud owned nextcloud/ocp package. The content is the same and all older versions were generated, so you can transition right away no matter which versions you support. We also have a GitHub Actions cron job template available at https://github.com/nextcloud/.github/blob/master/workflow-templates/update-nextcloud-ocp.yml which updates the packages every sunday, so you can make sure your app is still compatible with the latest OCP.

[korelstar]

@nickvergessen @ChristophWurst

Added:

Backend

• The christophwurst/nextcloud composer package was replaced with a now Nextcloud owned nextcloud/ocp package. The content is the same and all older versions were generated, so you can transition right away no matter which versions you support. We also have a GitHub Actions cron job template available at https://github.com/nextcloud/.github/blob/master/workflow-templates/update-nextcloud-ocp.yml which updates the packages every sunday, so you can make sure your app is still compatible with the latest OCP.

Sorry for disturbing this meta issue, but

1. there is no possibility to create issues in the new OCP repository: https://github.com/nextcloud-deps/ocp . Please allow issues over there!
2. there is no (beta) release for 25 on Packagist: https://packagist.org/packages/nextcloud/ocp . Could you please release a release? That would help apps preparing for the next server release.

Thanks!

[nickvergessen]

there is no (beta) release for 25 on Packagist: https://packagist.org/packages/nextcloud/ocp . Could you please release a release? That would help apps preparing for the next server release.

Instead of working with releases you should use the dev-stable25 branch:
https://github.com/nextcloud/spreed/blob/stable25/composer.json#L45

There is also a github action cron job available which updates this on a weekly basis so you immediately know when the target + your app is not compatible anymore.

there is no possibility to create issues in the new OCP repository: https://github.com/nextcloud-deps/ocp . Please allow issues over there!

This was because it's a fork of the old location. Enabled.

[nickvergessen]

• 26 list in Changes for developers & admins for Nextcloud 26 #34692

[come-nc]

#32363 from @CarlSchwan

[miaulalala]

Breaking change backend:

#33001 - ICreateFromString

/**
	 * @since 25.0.0
	 *
	 * @throws CalendarException
	 */
	public function handleIMipMessage(string $name, string $calendarData): void;

must be supported

Added

• ICreateFromString::handleIMipMessage(string $name, string $calendarData) must be supported

[nickvergessen]

26 follow up in #34692