diff --git a/docs/dotnet.rst b/docs/dotnet.rst index b67e3bbb..c1a58845 100644 --- a/docs/dotnet.rst +++ b/docs/dotnet.rst @@ -46,7 +46,7 @@ A few placeholders have been used in the steps below, while going through the st id: runtime: org.freedesktop.Platform - runtime-version: '23.08' + runtime-version: '24.08' sdk: org.freedesktop.Sdk sdk-extensions: - org.freedesktop.Sdk.Extension.dotnet8 diff --git a/docs/electron.rst b/docs/electron.rst index 24462d37..4e9f7eb6 100644 --- a/docs/electron.rst +++ b/docs/electron.rst @@ -44,7 +44,7 @@ ID. It also configures the runtime and SDK: id: org.flathub.electron-sample-app runtime: org.freedesktop.Platform - runtime-version: '23.08' + runtime-version: '24.08' sdk: org.freedesktop.Sdk The Freedesktop runtime is generally the best runtime to use with Electron @@ -61,7 +61,7 @@ manifest: .. code-block:: yaml base: org.electronjs.Electron2.BaseApp - base-version: '23.08' + base-version: '24.08' BaseApps are described in :doc:`dependencies`. Using the Electron base app is much faster and more convenient than manually building Electron diff --git a/docs/extension.rst b/docs/extension.rst index 43ec5b0e..b3879ff4 100644 --- a/docs/extension.rst +++ b/docs/extension.rst @@ -38,7 +38,7 @@ This is a typical example of an application extension point. id: org.flatpak.app runtime: org.gnome.Platform - runtime-version: '45' + runtime-version: '48' sdk: org.gnome.Sdk command: foo add-extensions: @@ -208,39 +208,73 @@ The extensions are mounted in alphabetical path order of directory. by Flatpak builder like ``.Locale, .Debug`` also do not need to be in application manifest. -``org.freedesktop.Platform.ffmpeg-full`` is an application extension -(mounted inside ``/app/extension_directory``) belonging to -``org.freedesktop.Platform``. +Finding Base Runtime Version +^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Some extensions are either built as part of the runtimes or have their +extension points defined within them. These typically follow the branch +pattern of the runtime. In case of +``org.gnome.{Platform, Sdk}, org.kde.{Platform, Sdk}`` they follow the +branch pattern of Freedesktop SDK (``org.freedesktop.{Platform, Sdk}``). + +When using such extensions, the extension version must match the base +runtime version. This ensures ABI and API compatibility. + +For example, ``org.freedesktop.Platform.ffmpeg-full`` is built as part +of the Freedesktop SDK and provides versions +``22.08, 23.08, 24.08, ...``. Suppose the application uses the runtime +``org.kde.Platform//5.15-24.08``, which is based on Freedesktop SDK. + +To find the base runtime version of ``org.kde.Platform//5.15-24.08``, +run:: + + flatpak remote-info flathub -m org.kde.Platform//5.15-24.08 | \ + grep -A 5 -F '[Extension org.freedesktop.Platform.GL]' + +The output will have ``versions=24.08;24.08-extra;1.4``, and thus the +base runtime version is of ````org.kde.Platform//5.15-24.08`` is +``24.08``. + +Similarly, for ``org.freedesktop.Sdk.Extension.texlive``, the extension +point ``org.freedesktop.Sdk.Extension`` is defined in the Freedesktop +SDK. To determine the base runtime version for a derived runtime such as +``org.gnome.Platform//48``, run:: + + flatpak remote-info flathub -m org.gnome.Sdk//48 | \ + grep -A 5 -F '[Extension org.freedesktop.Sdk.Extension]' + +The output will have ``versions=24.08``, and thus ``24.08`` needs +to be used as ``version`` in ``add-extensions``. + +Examples +^^^^^^^^^ .. code-block:: yaml id: org.flatpak.cool-app runtime: org.kde.Platform - runtime-version: '5.15-23.08' + runtime-version: '5.15-24.08' sdk: org.kde.Sdk command: foo add-extensions: org.freedesktop.Platform.ffmpeg-full: - version: '23.08' + version: '24.08' # replace by appropriate version directory: lib/ffmpeg add-ld-path: . cleanup-commands: - mkdir -p ${FLATPAK_DEST}/lib/ffmpeg -``org.freedesktop.Sdk.Extension`` is an extension point defined in -``org.freedesktop.Sdk``. - .. code-block:: yaml id: org.flatpak.cool-app - runtime: org.freedesktop.Platform - runtime-version: '23.08' + runtime: org.gnome.Platform + runtime-version: '48' sdk: org.freedesktop.Sdk command: foo add-extensions: org.freedesktop.Sdk.Extension.texlive: directory: texlive - version: '23.08' + version: '24.08' # replace by appropriate version cleanup-commands: - mkdir -p ${FLATPAK_DEST}/texlive @@ -248,10 +282,6 @@ Note that ``Compat`` or ``GL32`` extensions need to specifically requested. For providing runtime i386 support or for building i386 modules, please refer to :doc:`multiarch`. -There is currently no way to `request` autodownload of a runtime -extension from an application. The extension point in the runtime has -to be set to autodownload or the user has to manually install it. - A few related extension properties can be found in application or runtime manifests. These are: @@ -267,10 +297,10 @@ manifests. These are: id: org.flatpak.cool-app runtime: org.gnome.Platform - runtime-version: '45' + runtime-version: '48' sdk: org.gnome.Sdk base: org.winehq.Wine - base-version: stable-23.08 + base-version: stable-24.08 inherit-extensions: - org.freedesktop.Platform.GL32 - org.freedesktop.Platform.ffmpeg-full @@ -291,22 +321,23 @@ manifests. These are: id: org.flatpak.cool-app runtime: org.freedesktop.Platform - runtime-version: '23.08' + runtime-version: '24.08' sdk: org.freedesktop.Sdk add-build-extensions: - org.freedesktop.Sdk.Extension.openjdk11 command: foo - ``sdk-extensions`` can be used to install extra extensions having - an extension point in the parent runtime that has to be installed for the - app to build. These are similarly made available during build and - not in the final flatpak. + an extension point in the parent runtime that has to be installed for + the app to build. These are similarly made available during build and + not in the final flatpak. These always follow the branch pattern + of the base runtime (see above). .. code-block:: yaml id: org.flatpak.cool-app runtime: org.freedesktop.Platform - runtime-version: '23.08' + runtime-version: '24.08' sdk: org.freedesktop.Sdk sdk-extensions: - org.freedesktop.Sdk.Extension.golang @@ -348,7 +379,7 @@ is discussed below. branch: '1.0' runtime: org.flatpak.app runtime-version: 'stable' - sdk: org.gnome.Sdk//45 + sdk: org.gnome.Sdk//48 build-extension: true separate-locales: false build-options: @@ -441,7 +472,7 @@ exported into that extension. id: org.flatpak.cool-app runtime: org.kde.Platform - runtime-version: '6.7' + runtime-version: '6.9' sdk: org.kde.Sdk command: foo add-extensions: @@ -545,7 +576,7 @@ These are common to the Freedesktop SDK and runtime: has two branches ``${RUNTIME_VERSION}`` and ``${RUNTIME_VERSION}-extra``, the latter containing support for patented codecs. - + ``org.freedesktop.Platform.GL.Debug`` – Debug extension point for ``org.freedesktop.Platform.GL``, managed by the runtime but the user needs to explicitly install ``org.freedesktop.Platform.GL.Debug.default//${RUNTIME_VERSION}`` @@ -553,17 +584,17 @@ These are common to the Freedesktop SDK and runtime: to have the debug symbols available. The following extensions utilise the above two extension points:: - + org.freedesktop.Platform.GL.default//${RUNTIME_VERSION} org.freedesktop.Platform.GL.default//${RUNTIME_VERSION}-extra org.freedesktop.Platform.GL.Debug.default//${RUNTIME_VERSION} org.freedesktop.Platform.GL.Debug.default//${RUNTIME_VERSION}-extra - + org.freedesktop.Platform.GL32.default//${RUNTIME_VERSION} org.freedesktop.Platform.GL32.default//${RUNTIME_VERSION}-extra org.freedesktop.Platform.GL32.Debug.default//${RUNTIME_VERSION} org.freedesktop.Platform.GL32.Debug.default//${RUNTIME_VERSION}-extra - + org.freedesktop.Platform.GL.nvidia-${DRIVER_VERSION} org.freedesktop.Platform.GL32.nvidia-${DRIVER_VERSION} @@ -583,18 +614,31 @@ These are common to the Freedesktop SDK and runtime: provide extensions using this extension point. - ``org.freedesktop.Platform.VAAPI.Intel`` – Extension providing Intel VAAPI media drivers. This is automatically installed if the user - has an Intel GPU. - - This has a compat i386 extension ``org.freedesktop.Platform.VAAPI.Intel.i386``. - + has an Intel GPU. This has a compat i386 extension + ``org.freedesktop.Platform.VAAPI.Intel.i386``. +- ``org.freedesktop.Platform.VAAPI.nvidia`` – Extension providing Nvidia + VAAPI media drivers. This is automatically installed if the user + has an Nvidia GPU. This has a compat i386 extension + ``org.freedesktop.Platform.VAAPI.nvidia.i386``. - ``org.freedesktop.Platform.openh264`` – Extension providing OpenH264, - automatically installed by the runtime. -- ``org.freedesktop.Platform.ffmpeg`` – Extension providing ffmpeg with - support for patented codecs. This needs to explicitly added to the + automatically installed by the runtime. (This is discontinued since + Freedesktop SDK 25.08) +- ``org.freedesktop.Platform.ffmpeg-full`` – Extension providing ffmpeg + with support for patented codecs. This needs to explicitly added to the manifest using ``add-extensions`` by the developer, so that it becomes - available when the user installs it. - - This has a compat i386 extension ``org.freedesktop.Platform.ffmpeg_full.i386``. + available when the user installs it.This has a compat i386 extension + ``org.freedesktop.Platform.ffmpeg_full.i386``. (This is discontinued + since Freedesktop SDK 25.08) +- ``org.freedesktop.Platform.codecs-extra`` – This is the successor + to ``org.freedesktop.Platform.ffmpeg-full`` available since + Freedesktop SDK 25.08. This is a runtime extension and it will be + automatically installed by the runtime when installing an app. This + has a compat i386 extension + ``org.freedesktop.Platform.codecs_extra.i386``. The branch is set to + ``$freedesktop-sdk-version-extra`` i.e. ``25.08-extra, 26.08-extra`` + and so on. Users and distributors who want to block or not use + patented codecs can use ``flatpak mask`` to mask this extension or + the ``-extra`` branch pattern. These are only in Freedesktop SDK: diff --git a/docs/manifests.rst b/docs/manifests.rst index 3db45f46..729515f0 100644 --- a/docs/manifests.rst +++ b/docs/manifests.rst @@ -32,7 +32,7 @@ For example, the GNOME Dictionary manifest includes: id: org.gnome.Dictionary runtime: org.gnome.Platform - runtime-version: '45' + runtime-version: '48' sdk: org.gnome.Sdk command: gnome-dictionary diff --git a/docs/multiarch.rst b/docs/multiarch.rst index 26f84c12..f1725264 100644 --- a/docs/multiarch.rst +++ b/docs/multiarch.rst @@ -29,12 +29,12 @@ app, define an extension point for it in the app manifest: add-extensions: org.freedesktop.Platform.Compat.i386: directory: lib/i386-linux-gnu - version: '23.08' + version: '24.08' # This is not strictly required, but needed for debugging 32-bit programs org.freedesktop.Platform.Compat.i386.Debug: directory: lib/debug/lib/i386-linux-gnu - version: '23.08' + version: '24.08' no-autodownload: true For GNOME runtime, use ``org.gnome.Platform.Compat.i386`` instead. @@ -48,11 +48,11 @@ in general, you'll also need 32-bit GL drivers. Add an extension point for it: .. code-block:: yaml runtime: org.freedesktop.Platform - runtime-version: &runtime-version '23.08' + runtime-version: &runtime-version '24.08' # Synced from Freedesktop runtime # https://gitlab.com/freedesktop-sdk/freedesktop-sdk/-/blob/ed97d222b21d0a8744779ce6e5e8af5b032bfee1/elements/flatpak-images/include/platform-vars.yml#L2 x-gl-version: &gl-version '1.4' - x-gl-versions: &gl-versions 23.08;1.4 + x-gl-versions: &gl-versions 24.08;1.4 x-gl-merge-dirs: &gl-merge-dirs vulkan/icd.d;glvnd/egl_vendor.d;egl/egl_external_platform.d;OpenCL/vendors;lib/dri;lib/d3d;lib/gbm;vulkan/explicit_layer.d;vulkan/implicit_layer.d org.freedesktop.Platform.GL32: diff --git a/docs/qt.rst b/docs/qt.rst index 47c903cb..e93affc7 100644 --- a/docs/qt.rst +++ b/docs/qt.rst @@ -12,7 +12,7 @@ straight-forward. id: org.flatpak.qtdemo runtime: org.kde.Platform - runtime-version: '5.15-22.08' + runtime-version: '5.15-24.08' sdk: org.kde.Sdk command: flatpak-demo finish-args: diff --git a/po/de/LC_MESSAGES/conventions.po b/po/de/LC_MESSAGES/conventions.po index 704dd6be..0b769ab8 100644 --- a/po/de/LC_MESSAGES/conventions.po +++ b/po/de/LC_MESSAGES/conventions.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-06-30 14:59+0530\n" +"POT-Creation-Date: 2025-07-21 08:07+0530\n" "PO-Revision-Date: 2019-06-26 05:18-0400\n" "Last-Translator: Markus Richter \n" "Language: de\n" @@ -498,7 +498,7 @@ msgstr "" #: ../../conventions.rst:368 msgid "" "Qt: XDG base directories can be accessed with the `QStandardPaths Class " -"`_." +"`_." msgstr "" #: ../../conventions.rst:371 @@ -1135,3 +1135,9 @@ msgstr "" #~ " locations (see :doc:`sandbox-permissions`)." #~ msgstr "" +#~ msgid "" +#~ "Qt: XDG base directories can be " +#~ "accessed with the `QStandardPaths Class " +#~ "`_." +#~ msgstr "" + diff --git a/po/de/LC_MESSAGES/dotnet.po b/po/de/LC_MESSAGES/dotnet.po index fc2c89c8..c800eabe 100644 --- a/po/de/LC_MESSAGES/dotnet.po +++ b/po/de/LC_MESSAGES/dotnet.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-09-26 16:32-0300\n" +"POT-Creation-Date: 2025-07-21 08:07+0530\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: de\n" @@ -18,7 +18,7 @@ msgstr "" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.16.0\n" +"Generated-By: Babel 2.17.0\n" #: ../../dotnet.rst:2 msgid "Dotnet" @@ -55,64 +55,68 @@ msgid "`GTKSharp `_" msgstr "" #: ../../dotnet.rst:12 +msgid "`Gir.Core `_" +msgstr "" + +#: ../../dotnet.rst:13 msgid "" "The application's source code is hosted on a Git server such as GitHub, " "GitLab, or Bitbucket" msgstr "" -#: ../../dotnet.rst:15 +#: ../../dotnet.rst:16 msgid "Steps for Packaging" msgstr "" -#: ../../dotnet.rst:18 +#: ../../dotnet.rst:19 msgid "Installing Flatpak and Flatpak builder" msgstr "" -#: ../../dotnet.rst:20 +#: ../../dotnet.rst:21 msgid "" "Install Flatpak using the method provided for your distribution `Flatpak " "- Quick Setup `_" msgstr "" -#: ../../dotnet.rst:23 +#: ../../dotnet.rst:24 msgid "" "Install Flatpak Builder through your distribution package manager (e.g. " "``apt`` / ``dnf``)" msgstr "" -#: ../../dotnet.rst:31 +#: ../../dotnet.rst:32 msgid "Creating the Flatpak" msgstr "" -#: ../../dotnet.rst:33 +#: ../../dotnet.rst:34 msgid "" "A few placeholders have been used in the steps below, while going through" " the steps replace these with the ones respective to your project:" msgstr "" -#: ../../dotnet.rst:35 +#: ../../dotnet.rst:36 msgid "" "````: The name of your Flatpak, see :ref:`conventions:application" " ids`." msgstr "" -#: ../../dotnet.rst:36 +#: ../../dotnet.rst:37 msgid "````: The name of the root folder of your app repository" msgstr "" -#: ../../dotnet.rst:37 +#: ../../dotnet.rst:38 msgid "````: The name of your ``.csproj`` file" msgstr "" -#: ../../dotnet.rst:38 +#: ../../dotnet.rst:39 msgid "````: The URL to the git repository of the project" msgstr "" -#: ../../dotnet.rst:40 +#: ../../dotnet.rst:41 msgid "Create a new folder somewhere different from your existing project" msgstr "" -#: ../../dotnet.rst:42 +#: ../../dotnet.rst:43 msgid "" "Create a YAML file titled ``.yaml`` with the following example " "template, replacing the placeholders with the appropriate information. " @@ -120,13 +124,13 @@ msgid "" " in the build paths in this file and subsequent commands as well.):" msgstr "" -#: ../../dotnet.rst:87 +#: ../../dotnet.rst:88 msgid "" "For providing access to other things such as the network or filesystem, " "see :doc:`sandbox-permissions`" msgstr "" -#: ../../dotnet.rst:90 +#: ../../dotnet.rst:91 msgid "" "Copy and save the dotnet NuGet sources generator script ``flatpak-dotnet-" "generator.py`` from the `Flatpak Builder Tools repository " @@ -134,29 +138,29 @@ msgid "" "folder, or run the following command to download it:" msgstr "" -#: ../../dotnet.rst:99 +#: ../../dotnet.rst:100 msgid "Clone down your project repository to the folder" msgstr "" -#: ../../dotnet.rst:105 +#: ../../dotnet.rst:106 msgid "Install dependencies from Flathub" msgstr "" -#: ../../dotnet.rst:111 +#: ../../dotnet.rst:112 msgid "" "Run the NuGet source config generator script ``flatpak-dotnet-" "generator.py`` with the following arguments:" msgstr "" -#: ../../dotnet.rst:117 +#: ../../dotnet.rst:118 msgid "Build and install using Flatpak builder" msgstr "" -#: ../../dotnet.rst:125 +#: ../../dotnet.rst:126 msgid "Testing the build" msgstr "" -#: ../../dotnet.rst:127 +#: ../../dotnet.rst:128 msgid "Run the installed Flatpak application" msgstr "" diff --git a/po/de/LC_MESSAGES/extension.po b/po/de/LC_MESSAGES/extension.po index bfdf512d..fa1d639d 100644 --- a/po/de/LC_MESSAGES/extension.po +++ b/po/de/LC_MESSAGES/extension.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-03-13 09:30+0530\n" +"POT-Creation-Date: 2025-07-21 08:07+0530\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: de\n" @@ -314,40 +314,79 @@ msgid "" "manifest." msgstr "" -#: ../../extension.rst:211 +#: ../../extension.rst:212 +msgid "Finding Base Runtime Version" +msgstr "" + +#: ../../extension.rst:214 +#, python-brace-format msgid "" -"``org.freedesktop.Platform.ffmpeg-full`` is an application extension " -"(mounted inside ``/app/extension_directory``) belonging to " -"``org.freedesktop.Platform``." +"Some extensions are either built as part of the runtimes or have their " +"extension points defined within them. These typically follow the branch " +"pattern of the runtime. In case of ``org.gnome.{Platform, Sdk}, " +"org.kde.{Platform, Sdk}`` they follow the branch pattern of Freedesktop " +"SDK (``org.freedesktop.{Platform, Sdk}``)." msgstr "" -#: ../../extension.rst:230 +#: ../../extension.rst:220 msgid "" -"``org.freedesktop.Sdk.Extension`` is an extension point defined in " -"``org.freedesktop.Sdk``." +"When using such extensions, the extension version must match the base " +"runtime version. This ensures ABI and API compatibility." msgstr "" -#: ../../extension.rst:247 +#: ../../extension.rst:223 msgid "" -"Note that ``Compat`` or ``GL32`` extensions need to specifically " -"requested. For providing runtime i386 support or for building i386 " -"modules, please refer to :doc:`multiarch`." +"For example, ``org.freedesktop.Platform.ffmpeg-full`` is built as part of" +" the Freedesktop SDK and provides versions ``22.08, 23.08, 24.08, ...``. " +"Suppose the application uses the runtime " +"``org.kde.Platform//5.15-24.08``, which is based on Freedesktop SDK." +msgstr "" + +#: ../../extension.rst:228 +msgid "" +"To find the base runtime version of ``org.kde.Platform//5.15-24.08``, " +"run::" +msgstr "" + +#: ../../extension.rst:234 +msgid "" +"The output will have ``versions=24.08;24.08-extra;1.4``, and thus the " +"base runtime version is of ````org.kde.Platform//5.15-24.08`` is " +"``24.08``." +msgstr "" + +#: ../../extension.rst:238 +msgid "" +"Similarly, for ``org.freedesktop.Sdk.Extension.texlive``, the extension " +"point ``org.freedesktop.Sdk.Extension`` is defined in the Freedesktop " +"SDK. To determine the base runtime version for a derived runtime such as " +"``org.gnome.Platform//48``, run::" msgstr "" -#: ../../extension.rst:251 +#: ../../extension.rst:246 msgid "" -"There is currently no way to `request` autodownload of a runtime " -"extension from an application. The extension point in the runtime has to " -"be set to autodownload or the user has to manually install it." +"The output will have ``versions=24.08``, and thus ``24.08`` needs to be " +"used as ``version`` in ``add-extensions``." +msgstr "" + +#: ../../extension.rst:250 +msgid "Examples" +msgstr "" + +#: ../../extension.rst:281 +msgid "" +"Note that ``Compat`` or ``GL32`` extensions need to specifically " +"requested. For providing runtime i386 support or for building i386 " +"modules, please refer to :doc:`multiarch`." msgstr "" -#: ../../extension.rst:255 +#: ../../extension.rst:285 msgid "" "A few related extension properties can be found in application or runtime" " manifests. These are:" msgstr "" -#: ../../extension.rst:258 +#: ../../extension.rst:288 msgid "" "``inherit-extensions`` can be used to specify an extra set of extension " "points or extensions from the parent runtime or base that is inherited " @@ -358,29 +397,30 @@ msgid "" "it." msgstr "" -#: ../../extension.rst:281 +#: ../../extension.rst:311 msgid "" "``add-build-extensions`` is same as ``add-extensions`` but the extensions" " are made available during build. This can be used to add build " "dependencies that reside in an extension based on the runtime being used." msgstr "" -#: ../../extension.rst:286 +#: ../../extension.rst:316 msgid "" "For example an application using the runtime ``org.freedesktop.Platform``" " can use ``org.freedesktop.Sdk.Extension.openjdk11`` as a build-" "extension." msgstr "" -#: ../../extension.rst:300 +#: ../../extension.rst:330 msgid "" "``sdk-extensions`` can be used to install extra extensions having an " "extension point in the parent runtime that has to be installed for the " "app to build. These are similarly made available during build and not in " -"the final flatpak." +"the final flatpak. These always follow the branch pattern of the base " +"runtime (see above)." msgstr "" -#: ../../extension.rst:315 +#: ../../extension.rst:346 msgid "" "``inherit-sdk-extensions`` is used to inherit extension points from the " "parent SDK into the child SDK. They aren't inherited into the child " @@ -388,51 +428,51 @@ msgid "" "applications." msgstr "" -#: ../../extension.rst:328 +#: ../../extension.rst:359 msgid "" "There is currently no way to add or inherit extensions per-arch. This " "means the extension should be available or made available for all the " "arches used by the application and vice-versa." msgstr "" -#: ../../extension.rst:332 +#: ../../extension.rst:363 msgid "" "This also means that certain extensions like i386 compatibility " "extensions like ``org.freedesktop.Sdk.Compat.i386`` should not be added " "to modules that build for ``aarch64``." msgstr "" -#: ../../extension.rst:337 +#: ../../extension.rst:368 msgid "Extension manifest" msgstr "" -#: ../../extension.rst:339 +#: ../../extension.rst:370 msgid "" "Once the extension point is defined, an extension like " "``org.flatpak.app.plugin.foo`` can be created." msgstr "" -#: ../../extension.rst:342 +#: ../../extension.rst:373 msgid "" "This is a typical example of such an extension manifest. The explanation " "is discussed below." msgstr "" -#: ../../extension.rst:368 +#: ../../extension.rst:399 msgid "``id`` must have the correct prefix of the extension point." msgstr "" -#: ../../extension.rst:369 +#: ../../extension.rst:400 msgid "``branch`` must be the ``version`` declared in the extension point." msgstr "" -#: ../../extension.rst:370 +#: ../../extension.rst:401 msgid "" "``runtime`` should be the ID of the parent module where the extension " "point is defined." msgstr "" -#: ../../extension.rst:372 +#: ../../extension.rst:403 msgid "" "``runtime-version`` is the version of the runtime used by the " "application. If the runtime is built locally and has not specified the " @@ -440,34 +480,34 @@ msgid "" " the value in ``branch`` is used." msgstr "" -#: ../../extension.rst:377 +#: ../../extension.rst:408 msgid "Applications on Flathub usually use either ``stable`` or ``beta``." msgstr "" -#: ../../extension.rst:378 +#: ../../extension.rst:409 msgid "" "``sdk`` should be the same SDK used to build the runtime, followed by its" " version." msgstr "" -#: ../../extension.rst:380 +#: ../../extension.rst:411 msgid "``build-extension: true`` instructs flatpak to build an extension." msgstr "" -#: ../../extension.rst:381 +#: ../../extension.rst:412 msgid "" "``separate-locales: false`` disables creating a ``.Locale`` extension for" " this extension." msgstr "" -#: ../../extension.rst:384 +#: ../../extension.rst:415 msgid "" "Flatpak-builder (>= 1.3.4), can compose metadata for extensions " "automatically and it is no longer required to manually compose them " "through commands in the manifest." msgstr "" -#: ../../extension.rst:388 +#: ../../extension.rst:419 #, python-brace-format msgid "" "In case a manual compose is still required ``appstream-compose " @@ -480,7 +520,7 @@ msgid "" "compose: false`` in the top." msgstr "" -#: ../../extension.rst:393 +#: ../../extension.rst:424 msgid "" "Note that the extension prefix or location of pkg-config files will not " "be in ``$PATH`` or ``$PKG_CONFIG_PATH`` by default. Any such additional " @@ -488,17 +528,17 @@ msgid "" "``prefix`` and ``prepend-*`` properties." msgstr "" -#: ../../extension.rst:398 +#: ../../extension.rst:429 msgid "" "A MetaInfo file should be provided for discoverability in software " "stores. This is a typical example of an extension MetaInfo file." msgstr "" -#: ../../extension.rst:431 +#: ../../extension.rst:462 msgid "Bundled extensions" msgstr "" -#: ../../extension.rst:433 +#: ../../extension.rst:464 msgid "" "Extensions can also be built directly from the application manifest " "instead of creating a separate extension manifest. The ``bundle: true`` " @@ -508,11 +548,11 @@ msgid "" "``directory`` will be exported into that extension." msgstr "" -#: ../../extension.rst:465 +#: ../../extension.rst:496 msgid "Unmaintained Flatpak extensions" msgstr "" -#: ../../extension.rst:467 +#: ../../extension.rst:498 msgid "" "Flatpak also supports `unmaintained extensions` that allows loading " "extensions installed externally into ``/var/lib/flatpak/extension`` and " @@ -522,7 +562,7 @@ msgid "" "the same as above." msgstr "" -#: ../../extension.rst:474 +#: ../../extension.rst:505 msgid "" "An example of an unmaintained extension can be found in browsers such as " "`Chromium " @@ -532,11 +572,11 @@ msgid "" "/firefox-flatpak/runme.sh>`_ on Flathub." msgstr "" -#: ../../extension.rst:479 +#: ../../extension.rst:510 msgid "The Firefox snippet translates to:" msgstr "" -#: ../../extension.rst:490 +#: ../../extension.rst:521 msgid "" "Now the required policy files for Firefox ``pref`` and ``policies.json`` " "can be placed in " @@ -552,34 +592,34 @@ msgid "" " reading policies from ``/app/etc``)" msgstr "" -#: ../../extension.rst:499 +#: ../../extension.rst:530 msgid "" "For details on Chromium, please look at the `readme " "`_." msgstr "" -#: ../../extension.rst:503 +#: ../../extension.rst:534 msgid "Creating an unmaintained Gtk theme extension" msgstr "" -#: ../../extension.rst:505 +#: ../../extension.rst:536 msgid "" "The following script can be used to create an unmaintained extension for " "the host's Gtk 3 theme. This is useful when the theme is not packaged as " "an extension in a remote." msgstr "" -#: ../../extension.rst:509 +#: ../../extension.rst:540 msgid "" "The script expects the theme to be installed in ``/usr/share/themes`` or " "``$XDG_DATA_HOME/themes``." msgstr "" -#: ../../extension.rst:534 +#: ../../extension.rst:565 msgid "Extensions or extension points defined by runtime" msgstr "" -#: ../../extension.rst:536 +#: ../../extension.rst:567 msgid "" "The following extensions and extension points are defined in the " "Freedesktop runtime/SDK or are shipped along with it. Most of these are " @@ -587,11 +627,11 @@ msgid "" "time, please check the respective project." msgstr "" -#: ../../extension.rst:541 +#: ../../extension.rst:572 msgid "These are common to the Freedesktop SDK and runtime:" msgstr "" -#: ../../extension.rst:543 +#: ../../extension.rst:574 #, python-brace-format msgid "" "``org.freedesktop.Platform.GL`` – Extension for graphics drivers managed " @@ -600,7 +640,7 @@ msgid "" " latter containing support for patented codecs." msgstr "" -#: ../../extension.rst:549 +#: ../../extension.rst:580 #, python-brace-format msgid "" "``org.freedesktop.Platform.GL.Debug`` – Debug extension point for " @@ -611,11 +651,11 @@ msgid "" "to have the debug symbols available." msgstr "" -#: ../../extension.rst:555 +#: ../../extension.rst:586 msgid "The following extensions utilise the above two extension points::" msgstr "" -#: ../../extension.rst:570 +#: ../../extension.rst:601 msgid "" "``org.freedesktop.Platform.VulkanLayer`` – Extension point for `Vulkan " "layers `_." msgstr "" -#: ../../extension.rst:609 +#: ../../extension.rst:653 msgid "" "The application developer needs to explicitly add these extensions in the" " manifest by using ``sdk-extensions`` when building an app." msgstr "" -#: ../../extension.rst:612 +#: ../../extension.rst:656 msgid "" "Extensions marked as ``Compat`` in the name or ``GL32`` provide compat " "support for extra architectures and needs to explicitly requested." msgstr "" -#: ../../extension.rst:615 +#: ../../extension.rst:659 msgid "Additionally all SDKs provide a ``.Docs`` extension for documentation." msgstr "" @@ -845,3 +898,67 @@ msgstr "" #~ "for development tools such as IDEs." #~ msgstr "" +#~ msgid "" +#~ "``org.freedesktop.Platform.ffmpeg-full`` is an " +#~ "application extension (mounted inside " +#~ "``/app/extension_directory``) belonging to " +#~ "``org.freedesktop.Platform``." +#~ msgstr "" + +#~ msgid "" +#~ "``org.freedesktop.Sdk.Extension`` is an extension" +#~ " point defined in ``org.freedesktop.Sdk``." +#~ msgstr "" + +#~ msgid "" +#~ "There is currently no way to " +#~ "`request` autodownload of a runtime " +#~ "extension from an application. The " +#~ "extension point in the runtime has " +#~ "to be set to autodownload or the" +#~ " user has to manually install it." +#~ msgstr "" + +#~ msgid "" +#~ "``sdk-extensions`` can be used to " +#~ "install extra extensions having an " +#~ "extension point in the parent runtime" +#~ " that has to be installed for " +#~ "the app to build. These are " +#~ "similarly made available during build " +#~ "and not in the final flatpak." +#~ msgstr "" + +#~ msgid "" +#~ "``org.freedesktop.Platform.VAAPI.Intel`` – Extension " +#~ "providing Intel VAAPI media drivers. " +#~ "This is automatically installed if the" +#~ " user has an Intel GPU." +#~ msgstr "" + +#~ msgid "" +#~ "This has a compat i386 extension " +#~ "``org.freedesktop.Platform.VAAPI.Intel.i386``." +#~ msgstr "" + +#~ msgid "" +#~ "``org.freedesktop.Platform.openh264`` – Extension " +#~ "providing OpenH264, automatically installed by" +#~ " the runtime." +#~ msgstr "" + +#~ msgid "" +#~ "``org.freedesktop.Platform.ffmpeg`` – Extension " +#~ "providing ffmpeg with support for " +#~ "patented codecs. This needs to " +#~ "explicitly added to the manifest using" +#~ " ``add-extensions`` by the developer, " +#~ "so that it becomes available when " +#~ "the user installs it." +#~ msgstr "" + +#~ msgid "" +#~ "This has a compat i386 extension " +#~ "``org.freedesktop.Platform.ffmpeg_full.i386``." +#~ msgstr "" + diff --git a/po/de/LC_MESSAGES/manifests.po b/po/de/LC_MESSAGES/manifests.po index 9dce17a3..fbd135ac 100644 --- a/po/de/LC_MESSAGES/manifests.po +++ b/po/de/LC_MESSAGES/manifests.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-05 01:10+0530\n" +"POT-Creation-Date: 2025-07-21 08:07+0530\n" "PO-Revision-Date: 2018-05-20 10:36-0400\n" "Last-Translator: Copied by Zanata \n" "Language: de\n" @@ -17,7 +17,7 @@ msgstr "" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.16.0\n" +"Generated-By: Babel 2.17.0\n" #: ../../manifests.rst:2 msgid "Manifests" @@ -314,7 +314,7 @@ msgid "`meson `_" msgstr "" #: ../../manifests.rst:264 -msgid "`qmake `_" +msgid "`qmake `_" msgstr "" #: ../../manifests.rst:266 @@ -577,3 +577,6 @@ msgstr "" #~ "`_." #~ msgstr "" +#~ msgid "`qmake `_" +#~ msgstr "" + diff --git a/po/es/LC_MESSAGES/conventions.po b/po/es/LC_MESSAGES/conventions.po index f0a4b52a..cfa43340 100644 --- a/po/es/LC_MESSAGES/conventions.po +++ b/po/es/LC_MESSAGES/conventions.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-06-30 14:59+0530\n" +"POT-Creation-Date: 2025-07-21 08:07+0530\n" "PO-Revision-Date: 2018-05-20 10:37-0400\n" "Last-Translator: Copied by Zanata \n" "Language: es\n" @@ -497,7 +497,7 @@ msgstr "" #: ../../conventions.rst:368 msgid "" "Qt: XDG base directories can be accessed with the `QStandardPaths Class " -"`_." +"`_." msgstr "" #: ../../conventions.rst:371 @@ -1134,3 +1134,9 @@ msgstr "" #~ " locations (see :doc:`sandbox-permissions`)." #~ msgstr "" +#~ msgid "" +#~ "Qt: XDG base directories can be " +#~ "accessed with the `QStandardPaths Class " +#~ "`_." +#~ msgstr "" + diff --git a/po/es/LC_MESSAGES/dotnet.po b/po/es/LC_MESSAGES/dotnet.po index 829d83f5..f7cf1b92 100644 --- a/po/es/LC_MESSAGES/dotnet.po +++ b/po/es/LC_MESSAGES/dotnet.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-09-26 16:32-0300\n" +"POT-Creation-Date: 2025-07-21 08:07+0530\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: es\n" @@ -18,7 +18,7 @@ msgstr "" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.16.0\n" +"Generated-By: Babel 2.17.0\n" #: ../../dotnet.rst:2 msgid "Dotnet" @@ -55,64 +55,68 @@ msgid "`GTKSharp `_" msgstr "" #: ../../dotnet.rst:12 +msgid "`Gir.Core `_" +msgstr "" + +#: ../../dotnet.rst:13 msgid "" "The application's source code is hosted on a Git server such as GitHub, " "GitLab, or Bitbucket" msgstr "" -#: ../../dotnet.rst:15 +#: ../../dotnet.rst:16 msgid "Steps for Packaging" msgstr "" -#: ../../dotnet.rst:18 +#: ../../dotnet.rst:19 msgid "Installing Flatpak and Flatpak builder" msgstr "" -#: ../../dotnet.rst:20 +#: ../../dotnet.rst:21 msgid "" "Install Flatpak using the method provided for your distribution `Flatpak " "- Quick Setup `_" msgstr "" -#: ../../dotnet.rst:23 +#: ../../dotnet.rst:24 msgid "" "Install Flatpak Builder through your distribution package manager (e.g. " "``apt`` / ``dnf``)" msgstr "" -#: ../../dotnet.rst:31 +#: ../../dotnet.rst:32 msgid "Creating the Flatpak" msgstr "" -#: ../../dotnet.rst:33 +#: ../../dotnet.rst:34 msgid "" "A few placeholders have been used in the steps below, while going through" " the steps replace these with the ones respective to your project:" msgstr "" -#: ../../dotnet.rst:35 +#: ../../dotnet.rst:36 msgid "" "````: The name of your Flatpak, see :ref:`conventions:application" " ids`." msgstr "" -#: ../../dotnet.rst:36 +#: ../../dotnet.rst:37 msgid "````: The name of the root folder of your app repository" msgstr "" -#: ../../dotnet.rst:37 +#: ../../dotnet.rst:38 msgid "````: The name of your ``.csproj`` file" msgstr "" -#: ../../dotnet.rst:38 +#: ../../dotnet.rst:39 msgid "````: The URL to the git repository of the project" msgstr "" -#: ../../dotnet.rst:40 +#: ../../dotnet.rst:41 msgid "Create a new folder somewhere different from your existing project" msgstr "" -#: ../../dotnet.rst:42 +#: ../../dotnet.rst:43 msgid "" "Create a YAML file titled ``.yaml`` with the following example " "template, replacing the placeholders with the appropriate information. " @@ -120,13 +124,13 @@ msgid "" " in the build paths in this file and subsequent commands as well.):" msgstr "" -#: ../../dotnet.rst:87 +#: ../../dotnet.rst:88 msgid "" "For providing access to other things such as the network or filesystem, " "see :doc:`sandbox-permissions`" msgstr "" -#: ../../dotnet.rst:90 +#: ../../dotnet.rst:91 msgid "" "Copy and save the dotnet NuGet sources generator script ``flatpak-dotnet-" "generator.py`` from the `Flatpak Builder Tools repository " @@ -134,29 +138,29 @@ msgid "" "folder, or run the following command to download it:" msgstr "" -#: ../../dotnet.rst:99 +#: ../../dotnet.rst:100 msgid "Clone down your project repository to the folder" msgstr "" -#: ../../dotnet.rst:105 +#: ../../dotnet.rst:106 msgid "Install dependencies from Flathub" msgstr "" -#: ../../dotnet.rst:111 +#: ../../dotnet.rst:112 msgid "" "Run the NuGet source config generator script ``flatpak-dotnet-" "generator.py`` with the following arguments:" msgstr "" -#: ../../dotnet.rst:117 +#: ../../dotnet.rst:118 msgid "Build and install using Flatpak builder" msgstr "" -#: ../../dotnet.rst:125 +#: ../../dotnet.rst:126 msgid "Testing the build" msgstr "" -#: ../../dotnet.rst:127 +#: ../../dotnet.rst:128 msgid "Run the installed Flatpak application" msgstr "" diff --git a/po/es/LC_MESSAGES/extension.po b/po/es/LC_MESSAGES/extension.po index 746766fc..bd3ab07b 100644 --- a/po/es/LC_MESSAGES/extension.po +++ b/po/es/LC_MESSAGES/extension.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-03-13 09:30+0530\n" +"POT-Creation-Date: 2025-07-21 08:07+0530\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: es\n" @@ -314,40 +314,79 @@ msgid "" "manifest." msgstr "" -#: ../../extension.rst:211 +#: ../../extension.rst:212 +msgid "Finding Base Runtime Version" +msgstr "" + +#: ../../extension.rst:214 +#, python-brace-format msgid "" -"``org.freedesktop.Platform.ffmpeg-full`` is an application extension " -"(mounted inside ``/app/extension_directory``) belonging to " -"``org.freedesktop.Platform``." +"Some extensions are either built as part of the runtimes or have their " +"extension points defined within them. These typically follow the branch " +"pattern of the runtime. In case of ``org.gnome.{Platform, Sdk}, " +"org.kde.{Platform, Sdk}`` they follow the branch pattern of Freedesktop " +"SDK (``org.freedesktop.{Platform, Sdk}``)." msgstr "" -#: ../../extension.rst:230 +#: ../../extension.rst:220 msgid "" -"``org.freedesktop.Sdk.Extension`` is an extension point defined in " -"``org.freedesktop.Sdk``." +"When using such extensions, the extension version must match the base " +"runtime version. This ensures ABI and API compatibility." msgstr "" -#: ../../extension.rst:247 +#: ../../extension.rst:223 msgid "" -"Note that ``Compat`` or ``GL32`` extensions need to specifically " -"requested. For providing runtime i386 support or for building i386 " -"modules, please refer to :doc:`multiarch`." +"For example, ``org.freedesktop.Platform.ffmpeg-full`` is built as part of" +" the Freedesktop SDK and provides versions ``22.08, 23.08, 24.08, ...``. " +"Suppose the application uses the runtime " +"``org.kde.Platform//5.15-24.08``, which is based on Freedesktop SDK." +msgstr "" + +#: ../../extension.rst:228 +msgid "" +"To find the base runtime version of ``org.kde.Platform//5.15-24.08``, " +"run::" +msgstr "" + +#: ../../extension.rst:234 +msgid "" +"The output will have ``versions=24.08;24.08-extra;1.4``, and thus the " +"base runtime version is of ````org.kde.Platform//5.15-24.08`` is " +"``24.08``." +msgstr "" + +#: ../../extension.rst:238 +msgid "" +"Similarly, for ``org.freedesktop.Sdk.Extension.texlive``, the extension " +"point ``org.freedesktop.Sdk.Extension`` is defined in the Freedesktop " +"SDK. To determine the base runtime version for a derived runtime such as " +"``org.gnome.Platform//48``, run::" msgstr "" -#: ../../extension.rst:251 +#: ../../extension.rst:246 msgid "" -"There is currently no way to `request` autodownload of a runtime " -"extension from an application. The extension point in the runtime has to " -"be set to autodownload or the user has to manually install it." +"The output will have ``versions=24.08``, and thus ``24.08`` needs to be " +"used as ``version`` in ``add-extensions``." +msgstr "" + +#: ../../extension.rst:250 +msgid "Examples" +msgstr "" + +#: ../../extension.rst:281 +msgid "" +"Note that ``Compat`` or ``GL32`` extensions need to specifically " +"requested. For providing runtime i386 support or for building i386 " +"modules, please refer to :doc:`multiarch`." msgstr "" -#: ../../extension.rst:255 +#: ../../extension.rst:285 msgid "" "A few related extension properties can be found in application or runtime" " manifests. These are:" msgstr "" -#: ../../extension.rst:258 +#: ../../extension.rst:288 msgid "" "``inherit-extensions`` can be used to specify an extra set of extension " "points or extensions from the parent runtime or base that is inherited " @@ -358,29 +397,30 @@ msgid "" "it." msgstr "" -#: ../../extension.rst:281 +#: ../../extension.rst:311 msgid "" "``add-build-extensions`` is same as ``add-extensions`` but the extensions" " are made available during build. This can be used to add build " "dependencies that reside in an extension based on the runtime being used." msgstr "" -#: ../../extension.rst:286 +#: ../../extension.rst:316 msgid "" "For example an application using the runtime ``org.freedesktop.Platform``" " can use ``org.freedesktop.Sdk.Extension.openjdk11`` as a build-" "extension." msgstr "" -#: ../../extension.rst:300 +#: ../../extension.rst:330 msgid "" "``sdk-extensions`` can be used to install extra extensions having an " "extension point in the parent runtime that has to be installed for the " "app to build. These are similarly made available during build and not in " -"the final flatpak." +"the final flatpak. These always follow the branch pattern of the base " +"runtime (see above)." msgstr "" -#: ../../extension.rst:315 +#: ../../extension.rst:346 msgid "" "``inherit-sdk-extensions`` is used to inherit extension points from the " "parent SDK into the child SDK. They aren't inherited into the child " @@ -388,51 +428,51 @@ msgid "" "applications." msgstr "" -#: ../../extension.rst:328 +#: ../../extension.rst:359 msgid "" "There is currently no way to add or inherit extensions per-arch. This " "means the extension should be available or made available for all the " "arches used by the application and vice-versa." msgstr "" -#: ../../extension.rst:332 +#: ../../extension.rst:363 msgid "" "This also means that certain extensions like i386 compatibility " "extensions like ``org.freedesktop.Sdk.Compat.i386`` should not be added " "to modules that build for ``aarch64``." msgstr "" -#: ../../extension.rst:337 +#: ../../extension.rst:368 msgid "Extension manifest" msgstr "" -#: ../../extension.rst:339 +#: ../../extension.rst:370 msgid "" "Once the extension point is defined, an extension like " "``org.flatpak.app.plugin.foo`` can be created." msgstr "" -#: ../../extension.rst:342 +#: ../../extension.rst:373 msgid "" "This is a typical example of such an extension manifest. The explanation " "is discussed below." msgstr "" -#: ../../extension.rst:368 +#: ../../extension.rst:399 msgid "``id`` must have the correct prefix of the extension point." msgstr "" -#: ../../extension.rst:369 +#: ../../extension.rst:400 msgid "``branch`` must be the ``version`` declared in the extension point." msgstr "" -#: ../../extension.rst:370 +#: ../../extension.rst:401 msgid "" "``runtime`` should be the ID of the parent module where the extension " "point is defined." msgstr "" -#: ../../extension.rst:372 +#: ../../extension.rst:403 msgid "" "``runtime-version`` is the version of the runtime used by the " "application. If the runtime is built locally and has not specified the " @@ -440,34 +480,34 @@ msgid "" " the value in ``branch`` is used." msgstr "" -#: ../../extension.rst:377 +#: ../../extension.rst:408 msgid "Applications on Flathub usually use either ``stable`` or ``beta``." msgstr "" -#: ../../extension.rst:378 +#: ../../extension.rst:409 msgid "" "``sdk`` should be the same SDK used to build the runtime, followed by its" " version." msgstr "" -#: ../../extension.rst:380 +#: ../../extension.rst:411 msgid "``build-extension: true`` instructs flatpak to build an extension." msgstr "" -#: ../../extension.rst:381 +#: ../../extension.rst:412 msgid "" "``separate-locales: false`` disables creating a ``.Locale`` extension for" " this extension." msgstr "" -#: ../../extension.rst:384 +#: ../../extension.rst:415 msgid "" "Flatpak-builder (>= 1.3.4), can compose metadata for extensions " "automatically and it is no longer required to manually compose them " "through commands in the manifest." msgstr "" -#: ../../extension.rst:388 +#: ../../extension.rst:419 #, python-brace-format msgid "" "In case a manual compose is still required ``appstream-compose " @@ -480,7 +520,7 @@ msgid "" "compose: false`` in the top." msgstr "" -#: ../../extension.rst:393 +#: ../../extension.rst:424 msgid "" "Note that the extension prefix or location of pkg-config files will not " "be in ``$PATH`` or ``$PKG_CONFIG_PATH`` by default. Any such additional " @@ -488,17 +528,17 @@ msgid "" "``prefix`` and ``prepend-*`` properties." msgstr "" -#: ../../extension.rst:398 +#: ../../extension.rst:429 msgid "" "A MetaInfo file should be provided for discoverability in software " "stores. This is a typical example of an extension MetaInfo file." msgstr "" -#: ../../extension.rst:431 +#: ../../extension.rst:462 msgid "Bundled extensions" msgstr "" -#: ../../extension.rst:433 +#: ../../extension.rst:464 msgid "" "Extensions can also be built directly from the application manifest " "instead of creating a separate extension manifest. The ``bundle: true`` " @@ -508,11 +548,11 @@ msgid "" "``directory`` will be exported into that extension." msgstr "" -#: ../../extension.rst:465 +#: ../../extension.rst:496 msgid "Unmaintained Flatpak extensions" msgstr "" -#: ../../extension.rst:467 +#: ../../extension.rst:498 msgid "" "Flatpak also supports `unmaintained extensions` that allows loading " "extensions installed externally into ``/var/lib/flatpak/extension`` and " @@ -522,7 +562,7 @@ msgid "" "the same as above." msgstr "" -#: ../../extension.rst:474 +#: ../../extension.rst:505 msgid "" "An example of an unmaintained extension can be found in browsers such as " "`Chromium " @@ -532,11 +572,11 @@ msgid "" "/firefox-flatpak/runme.sh>`_ on Flathub." msgstr "" -#: ../../extension.rst:479 +#: ../../extension.rst:510 msgid "The Firefox snippet translates to:" msgstr "" -#: ../../extension.rst:490 +#: ../../extension.rst:521 msgid "" "Now the required policy files for Firefox ``pref`` and ``policies.json`` " "can be placed in " @@ -552,34 +592,34 @@ msgid "" " reading policies from ``/app/etc``)" msgstr "" -#: ../../extension.rst:499 +#: ../../extension.rst:530 msgid "" "For details on Chromium, please look at the `readme " "`_." msgstr "" -#: ../../extension.rst:503 +#: ../../extension.rst:534 msgid "Creating an unmaintained Gtk theme extension" msgstr "" -#: ../../extension.rst:505 +#: ../../extension.rst:536 msgid "" "The following script can be used to create an unmaintained extension for " "the host's Gtk 3 theme. This is useful when the theme is not packaged as " "an extension in a remote." msgstr "" -#: ../../extension.rst:509 +#: ../../extension.rst:540 msgid "" "The script expects the theme to be installed in ``/usr/share/themes`` or " "``$XDG_DATA_HOME/themes``." msgstr "" -#: ../../extension.rst:534 +#: ../../extension.rst:565 msgid "Extensions or extension points defined by runtime" msgstr "" -#: ../../extension.rst:536 +#: ../../extension.rst:567 msgid "" "The following extensions and extension points are defined in the " "Freedesktop runtime/SDK or are shipped along with it. Most of these are " @@ -587,11 +627,11 @@ msgid "" "time, please check the respective project." msgstr "" -#: ../../extension.rst:541 +#: ../../extension.rst:572 msgid "These are common to the Freedesktop SDK and runtime:" msgstr "" -#: ../../extension.rst:543 +#: ../../extension.rst:574 #, python-brace-format msgid "" "``org.freedesktop.Platform.GL`` – Extension for graphics drivers managed " @@ -600,7 +640,7 @@ msgid "" " latter containing support for patented codecs." msgstr "" -#: ../../extension.rst:549 +#: ../../extension.rst:580 #, python-brace-format msgid "" "``org.freedesktop.Platform.GL.Debug`` – Debug extension point for " @@ -611,11 +651,11 @@ msgid "" "to have the debug symbols available." msgstr "" -#: ../../extension.rst:555 +#: ../../extension.rst:586 msgid "The following extensions utilise the above two extension points::" msgstr "" -#: ../../extension.rst:570 +#: ../../extension.rst:601 msgid "" "``org.freedesktop.Platform.VulkanLayer`` – Extension point for `Vulkan " "layers `_." msgstr "" -#: ../../extension.rst:609 +#: ../../extension.rst:653 msgid "" "The application developer needs to explicitly add these extensions in the" " manifest by using ``sdk-extensions`` when building an app." msgstr "" -#: ../../extension.rst:612 +#: ../../extension.rst:656 msgid "" "Extensions marked as ``Compat`` in the name or ``GL32`` provide compat " "support for extra architectures and needs to explicitly requested." msgstr "" -#: ../../extension.rst:615 +#: ../../extension.rst:659 msgid "Additionally all SDKs provide a ``.Docs`` extension for documentation." msgstr "" @@ -845,3 +898,67 @@ msgstr "" #~ "for development tools such as IDEs." #~ msgstr "" +#~ msgid "" +#~ "``org.freedesktop.Platform.ffmpeg-full`` is an " +#~ "application extension (mounted inside " +#~ "``/app/extension_directory``) belonging to " +#~ "``org.freedesktop.Platform``." +#~ msgstr "" + +#~ msgid "" +#~ "``org.freedesktop.Sdk.Extension`` is an extension" +#~ " point defined in ``org.freedesktop.Sdk``." +#~ msgstr "" + +#~ msgid "" +#~ "There is currently no way to " +#~ "`request` autodownload of a runtime " +#~ "extension from an application. The " +#~ "extension point in the runtime has " +#~ "to be set to autodownload or the" +#~ " user has to manually install it." +#~ msgstr "" + +#~ msgid "" +#~ "``sdk-extensions`` can be used to " +#~ "install extra extensions having an " +#~ "extension point in the parent runtime" +#~ " that has to be installed for " +#~ "the app to build. These are " +#~ "similarly made available during build " +#~ "and not in the final flatpak." +#~ msgstr "" + +#~ msgid "" +#~ "``org.freedesktop.Platform.VAAPI.Intel`` – Extension " +#~ "providing Intel VAAPI media drivers. " +#~ "This is automatically installed if the" +#~ " user has an Intel GPU." +#~ msgstr "" + +#~ msgid "" +#~ "This has a compat i386 extension " +#~ "``org.freedesktop.Platform.VAAPI.Intel.i386``." +#~ msgstr "" + +#~ msgid "" +#~ "``org.freedesktop.Platform.openh264`` – Extension " +#~ "providing OpenH264, automatically installed by" +#~ " the runtime." +#~ msgstr "" + +#~ msgid "" +#~ "``org.freedesktop.Platform.ffmpeg`` – Extension " +#~ "providing ffmpeg with support for " +#~ "patented codecs. This needs to " +#~ "explicitly added to the manifest using" +#~ " ``add-extensions`` by the developer, " +#~ "so that it becomes available when " +#~ "the user installs it." +#~ msgstr "" + +#~ msgid "" +#~ "This has a compat i386 extension " +#~ "``org.freedesktop.Platform.ffmpeg_full.i386``." +#~ msgstr "" + diff --git a/po/es/LC_MESSAGES/manifests.po b/po/es/LC_MESSAGES/manifests.po index 15f94bc0..5c5a4a91 100644 --- a/po/es/LC_MESSAGES/manifests.po +++ b/po/es/LC_MESSAGES/manifests.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-05 01:10+0530\n" +"POT-Creation-Date: 2025-07-21 08:07+0530\n" "PO-Revision-Date: 2018-05-20 10:37-0400\n" "Last-Translator: Copied by Zanata \n" "Language: es\n" @@ -17,7 +17,7 @@ msgstr "" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.16.0\n" +"Generated-By: Babel 2.17.0\n" #: ../../manifests.rst:2 msgid "Manifests" @@ -314,7 +314,7 @@ msgid "`meson `_" msgstr "" #: ../../manifests.rst:264 -msgid "`qmake `_" +msgid "`qmake `_" msgstr "" #: ../../manifests.rst:266 @@ -577,3 +577,6 @@ msgstr "" #~ "`_." #~ msgstr "" +#~ msgid "`qmake `_" +#~ msgstr "" + diff --git a/po/fr/LC_MESSAGES/conventions.po b/po/fr/LC_MESSAGES/conventions.po index d9c8de4a..4dc76faf 100644 --- a/po/fr/LC_MESSAGES/conventions.po +++ b/po/fr/LC_MESSAGES/conventions.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-06-30 14:59+0530\n" +"POT-Creation-Date: 2025-07-21 08:07+0530\n" "PO-Revision-Date: 2018-05-20 03:50-0400\n" "Last-Translator: Baptiste Mille-Mathias " "\n" @@ -499,7 +499,7 @@ msgstr "" #: ../../conventions.rst:368 msgid "" "Qt: XDG base directories can be accessed with the `QStandardPaths Class " -"`_." +"`_." msgstr "" #: ../../conventions.rst:371 @@ -1137,3 +1137,9 @@ msgstr "" #~ " locations (see :doc:`sandbox-permissions`)." #~ msgstr "" +#~ msgid "" +#~ "Qt: XDG base directories can be " +#~ "accessed with the `QStandardPaths Class " +#~ "`_." +#~ msgstr "" + diff --git a/po/fr/LC_MESSAGES/dotnet.po b/po/fr/LC_MESSAGES/dotnet.po index 1d797384..744ef61e 100644 --- a/po/fr/LC_MESSAGES/dotnet.po +++ b/po/fr/LC_MESSAGES/dotnet.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-09-26 16:32-0300\n" +"POT-Creation-Date: 2025-07-21 08:07+0530\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: fr\n" @@ -18,7 +18,7 @@ msgstr "" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.16.0\n" +"Generated-By: Babel 2.17.0\n" #: ../../dotnet.rst:2 msgid "Dotnet" @@ -55,64 +55,68 @@ msgid "`GTKSharp `_" msgstr "" #: ../../dotnet.rst:12 +msgid "`Gir.Core `_" +msgstr "" + +#: ../../dotnet.rst:13 msgid "" "The application's source code is hosted on a Git server such as GitHub, " "GitLab, or Bitbucket" msgstr "" -#: ../../dotnet.rst:15 +#: ../../dotnet.rst:16 msgid "Steps for Packaging" msgstr "" -#: ../../dotnet.rst:18 +#: ../../dotnet.rst:19 msgid "Installing Flatpak and Flatpak builder" msgstr "" -#: ../../dotnet.rst:20 +#: ../../dotnet.rst:21 msgid "" "Install Flatpak using the method provided for your distribution `Flatpak " "- Quick Setup `_" msgstr "" -#: ../../dotnet.rst:23 +#: ../../dotnet.rst:24 msgid "" "Install Flatpak Builder through your distribution package manager (e.g. " "``apt`` / ``dnf``)" msgstr "" -#: ../../dotnet.rst:31 +#: ../../dotnet.rst:32 msgid "Creating the Flatpak" msgstr "" -#: ../../dotnet.rst:33 +#: ../../dotnet.rst:34 msgid "" "A few placeholders have been used in the steps below, while going through" " the steps replace these with the ones respective to your project:" msgstr "" -#: ../../dotnet.rst:35 +#: ../../dotnet.rst:36 msgid "" "````: The name of your Flatpak, see :ref:`conventions:application" " ids`." msgstr "" -#: ../../dotnet.rst:36 +#: ../../dotnet.rst:37 msgid "````: The name of the root folder of your app repository" msgstr "" -#: ../../dotnet.rst:37 +#: ../../dotnet.rst:38 msgid "````: The name of your ``.csproj`` file" msgstr "" -#: ../../dotnet.rst:38 +#: ../../dotnet.rst:39 msgid "````: The URL to the git repository of the project" msgstr "" -#: ../../dotnet.rst:40 +#: ../../dotnet.rst:41 msgid "Create a new folder somewhere different from your existing project" msgstr "" -#: ../../dotnet.rst:42 +#: ../../dotnet.rst:43 msgid "" "Create a YAML file titled ``.yaml`` with the following example " "template, replacing the placeholders with the appropriate information. " @@ -120,13 +124,13 @@ msgid "" " in the build paths in this file and subsequent commands as well.):" msgstr "" -#: ../../dotnet.rst:87 +#: ../../dotnet.rst:88 msgid "" "For providing access to other things such as the network or filesystem, " "see :doc:`sandbox-permissions`" msgstr "" -#: ../../dotnet.rst:90 +#: ../../dotnet.rst:91 msgid "" "Copy and save the dotnet NuGet sources generator script ``flatpak-dotnet-" "generator.py`` from the `Flatpak Builder Tools repository " @@ -134,29 +138,29 @@ msgid "" "folder, or run the following command to download it:" msgstr "" -#: ../../dotnet.rst:99 +#: ../../dotnet.rst:100 msgid "Clone down your project repository to the folder" msgstr "" -#: ../../dotnet.rst:105 +#: ../../dotnet.rst:106 msgid "Install dependencies from Flathub" msgstr "" -#: ../../dotnet.rst:111 +#: ../../dotnet.rst:112 msgid "" "Run the NuGet source config generator script ``flatpak-dotnet-" "generator.py`` with the following arguments:" msgstr "" -#: ../../dotnet.rst:117 +#: ../../dotnet.rst:118 msgid "Build and install using Flatpak builder" msgstr "" -#: ../../dotnet.rst:125 +#: ../../dotnet.rst:126 msgid "Testing the build" msgstr "" -#: ../../dotnet.rst:127 +#: ../../dotnet.rst:128 msgid "Run the installed Flatpak application" msgstr "" diff --git a/po/fr/LC_MESSAGES/extension.po b/po/fr/LC_MESSAGES/extension.po index 0af239c6..01ed64ed 100644 --- a/po/fr/LC_MESSAGES/extension.po +++ b/po/fr/LC_MESSAGES/extension.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-03-13 09:30+0530\n" +"POT-Creation-Date: 2025-07-21 08:07+0530\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: fr\n" @@ -314,40 +314,79 @@ msgid "" "manifest." msgstr "" -#: ../../extension.rst:211 +#: ../../extension.rst:212 +msgid "Finding Base Runtime Version" +msgstr "" + +#: ../../extension.rst:214 +#, python-brace-format msgid "" -"``org.freedesktop.Platform.ffmpeg-full`` is an application extension " -"(mounted inside ``/app/extension_directory``) belonging to " -"``org.freedesktop.Platform``." +"Some extensions are either built as part of the runtimes or have their " +"extension points defined within them. These typically follow the branch " +"pattern of the runtime. In case of ``org.gnome.{Platform, Sdk}, " +"org.kde.{Platform, Sdk}`` they follow the branch pattern of Freedesktop " +"SDK (``org.freedesktop.{Platform, Sdk}``)." msgstr "" -#: ../../extension.rst:230 +#: ../../extension.rst:220 msgid "" -"``org.freedesktop.Sdk.Extension`` is an extension point defined in " -"``org.freedesktop.Sdk``." +"When using such extensions, the extension version must match the base " +"runtime version. This ensures ABI and API compatibility." msgstr "" -#: ../../extension.rst:247 +#: ../../extension.rst:223 msgid "" -"Note that ``Compat`` or ``GL32`` extensions need to specifically " -"requested. For providing runtime i386 support or for building i386 " -"modules, please refer to :doc:`multiarch`." +"For example, ``org.freedesktop.Platform.ffmpeg-full`` is built as part of" +" the Freedesktop SDK and provides versions ``22.08, 23.08, 24.08, ...``. " +"Suppose the application uses the runtime " +"``org.kde.Platform//5.15-24.08``, which is based on Freedesktop SDK." +msgstr "" + +#: ../../extension.rst:228 +msgid "" +"To find the base runtime version of ``org.kde.Platform//5.15-24.08``, " +"run::" +msgstr "" + +#: ../../extension.rst:234 +msgid "" +"The output will have ``versions=24.08;24.08-extra;1.4``, and thus the " +"base runtime version is of ````org.kde.Platform//5.15-24.08`` is " +"``24.08``." +msgstr "" + +#: ../../extension.rst:238 +msgid "" +"Similarly, for ``org.freedesktop.Sdk.Extension.texlive``, the extension " +"point ``org.freedesktop.Sdk.Extension`` is defined in the Freedesktop " +"SDK. To determine the base runtime version for a derived runtime such as " +"``org.gnome.Platform//48``, run::" msgstr "" -#: ../../extension.rst:251 +#: ../../extension.rst:246 msgid "" -"There is currently no way to `request` autodownload of a runtime " -"extension from an application. The extension point in the runtime has to " -"be set to autodownload or the user has to manually install it." +"The output will have ``versions=24.08``, and thus ``24.08`` needs to be " +"used as ``version`` in ``add-extensions``." +msgstr "" + +#: ../../extension.rst:250 +msgid "Examples" +msgstr "" + +#: ../../extension.rst:281 +msgid "" +"Note that ``Compat`` or ``GL32`` extensions need to specifically " +"requested. For providing runtime i386 support or for building i386 " +"modules, please refer to :doc:`multiarch`." msgstr "" -#: ../../extension.rst:255 +#: ../../extension.rst:285 msgid "" "A few related extension properties can be found in application or runtime" " manifests. These are:" msgstr "" -#: ../../extension.rst:258 +#: ../../extension.rst:288 msgid "" "``inherit-extensions`` can be used to specify an extra set of extension " "points or extensions from the parent runtime or base that is inherited " @@ -358,29 +397,30 @@ msgid "" "it." msgstr "" -#: ../../extension.rst:281 +#: ../../extension.rst:311 msgid "" "``add-build-extensions`` is same as ``add-extensions`` but the extensions" " are made available during build. This can be used to add build " "dependencies that reside in an extension based on the runtime being used." msgstr "" -#: ../../extension.rst:286 +#: ../../extension.rst:316 msgid "" "For example an application using the runtime ``org.freedesktop.Platform``" " can use ``org.freedesktop.Sdk.Extension.openjdk11`` as a build-" "extension." msgstr "" -#: ../../extension.rst:300 +#: ../../extension.rst:330 msgid "" "``sdk-extensions`` can be used to install extra extensions having an " "extension point in the parent runtime that has to be installed for the " "app to build. These are similarly made available during build and not in " -"the final flatpak." +"the final flatpak. These always follow the branch pattern of the base " +"runtime (see above)." msgstr "" -#: ../../extension.rst:315 +#: ../../extension.rst:346 msgid "" "``inherit-sdk-extensions`` is used to inherit extension points from the " "parent SDK into the child SDK. They aren't inherited into the child " @@ -388,51 +428,51 @@ msgid "" "applications." msgstr "" -#: ../../extension.rst:328 +#: ../../extension.rst:359 msgid "" "There is currently no way to add or inherit extensions per-arch. This " "means the extension should be available or made available for all the " "arches used by the application and vice-versa." msgstr "" -#: ../../extension.rst:332 +#: ../../extension.rst:363 msgid "" "This also means that certain extensions like i386 compatibility " "extensions like ``org.freedesktop.Sdk.Compat.i386`` should not be added " "to modules that build for ``aarch64``." msgstr "" -#: ../../extension.rst:337 +#: ../../extension.rst:368 msgid "Extension manifest" msgstr "" -#: ../../extension.rst:339 +#: ../../extension.rst:370 msgid "" "Once the extension point is defined, an extension like " "``org.flatpak.app.plugin.foo`` can be created." msgstr "" -#: ../../extension.rst:342 +#: ../../extension.rst:373 msgid "" "This is a typical example of such an extension manifest. The explanation " "is discussed below." msgstr "" -#: ../../extension.rst:368 +#: ../../extension.rst:399 msgid "``id`` must have the correct prefix of the extension point." msgstr "" -#: ../../extension.rst:369 +#: ../../extension.rst:400 msgid "``branch`` must be the ``version`` declared in the extension point." msgstr "" -#: ../../extension.rst:370 +#: ../../extension.rst:401 msgid "" "``runtime`` should be the ID of the parent module where the extension " "point is defined." msgstr "" -#: ../../extension.rst:372 +#: ../../extension.rst:403 msgid "" "``runtime-version`` is the version of the runtime used by the " "application. If the runtime is built locally and has not specified the " @@ -440,34 +480,34 @@ msgid "" " the value in ``branch`` is used." msgstr "" -#: ../../extension.rst:377 +#: ../../extension.rst:408 msgid "Applications on Flathub usually use either ``stable`` or ``beta``." msgstr "" -#: ../../extension.rst:378 +#: ../../extension.rst:409 msgid "" "``sdk`` should be the same SDK used to build the runtime, followed by its" " version." msgstr "" -#: ../../extension.rst:380 +#: ../../extension.rst:411 msgid "``build-extension: true`` instructs flatpak to build an extension." msgstr "" -#: ../../extension.rst:381 +#: ../../extension.rst:412 msgid "" "``separate-locales: false`` disables creating a ``.Locale`` extension for" " this extension." msgstr "" -#: ../../extension.rst:384 +#: ../../extension.rst:415 msgid "" "Flatpak-builder (>= 1.3.4), can compose metadata for extensions " "automatically and it is no longer required to manually compose them " "through commands in the manifest." msgstr "" -#: ../../extension.rst:388 +#: ../../extension.rst:419 #, python-brace-format msgid "" "In case a manual compose is still required ``appstream-compose " @@ -480,7 +520,7 @@ msgid "" "compose: false`` in the top." msgstr "" -#: ../../extension.rst:393 +#: ../../extension.rst:424 msgid "" "Note that the extension prefix or location of pkg-config files will not " "be in ``$PATH`` or ``$PKG_CONFIG_PATH`` by default. Any such additional " @@ -488,17 +528,17 @@ msgid "" "``prefix`` and ``prepend-*`` properties." msgstr "" -#: ../../extension.rst:398 +#: ../../extension.rst:429 msgid "" "A MetaInfo file should be provided for discoverability in software " "stores. This is a typical example of an extension MetaInfo file." msgstr "" -#: ../../extension.rst:431 +#: ../../extension.rst:462 msgid "Bundled extensions" msgstr "" -#: ../../extension.rst:433 +#: ../../extension.rst:464 msgid "" "Extensions can also be built directly from the application manifest " "instead of creating a separate extension manifest. The ``bundle: true`` " @@ -508,11 +548,11 @@ msgid "" "``directory`` will be exported into that extension." msgstr "" -#: ../../extension.rst:465 +#: ../../extension.rst:496 msgid "Unmaintained Flatpak extensions" msgstr "" -#: ../../extension.rst:467 +#: ../../extension.rst:498 msgid "" "Flatpak also supports `unmaintained extensions` that allows loading " "extensions installed externally into ``/var/lib/flatpak/extension`` and " @@ -522,7 +562,7 @@ msgid "" "the same as above." msgstr "" -#: ../../extension.rst:474 +#: ../../extension.rst:505 msgid "" "An example of an unmaintained extension can be found in browsers such as " "`Chromium " @@ -532,11 +572,11 @@ msgid "" "/firefox-flatpak/runme.sh>`_ on Flathub." msgstr "" -#: ../../extension.rst:479 +#: ../../extension.rst:510 msgid "The Firefox snippet translates to:" msgstr "" -#: ../../extension.rst:490 +#: ../../extension.rst:521 msgid "" "Now the required policy files for Firefox ``pref`` and ``policies.json`` " "can be placed in " @@ -552,34 +592,34 @@ msgid "" " reading policies from ``/app/etc``)" msgstr "" -#: ../../extension.rst:499 +#: ../../extension.rst:530 msgid "" "For details on Chromium, please look at the `readme " "`_." msgstr "" -#: ../../extension.rst:503 +#: ../../extension.rst:534 msgid "Creating an unmaintained Gtk theme extension" msgstr "" -#: ../../extension.rst:505 +#: ../../extension.rst:536 msgid "" "The following script can be used to create an unmaintained extension for " "the host's Gtk 3 theme. This is useful when the theme is not packaged as " "an extension in a remote." msgstr "" -#: ../../extension.rst:509 +#: ../../extension.rst:540 msgid "" "The script expects the theme to be installed in ``/usr/share/themes`` or " "``$XDG_DATA_HOME/themes``." msgstr "" -#: ../../extension.rst:534 +#: ../../extension.rst:565 msgid "Extensions or extension points defined by runtime" msgstr "" -#: ../../extension.rst:536 +#: ../../extension.rst:567 msgid "" "The following extensions and extension points are defined in the " "Freedesktop runtime/SDK or are shipped along with it. Most of these are " @@ -587,11 +627,11 @@ msgid "" "time, please check the respective project." msgstr "" -#: ../../extension.rst:541 +#: ../../extension.rst:572 msgid "These are common to the Freedesktop SDK and runtime:" msgstr "" -#: ../../extension.rst:543 +#: ../../extension.rst:574 #, python-brace-format msgid "" "``org.freedesktop.Platform.GL`` – Extension for graphics drivers managed " @@ -600,7 +640,7 @@ msgid "" " latter containing support for patented codecs." msgstr "" -#: ../../extension.rst:549 +#: ../../extension.rst:580 #, python-brace-format msgid "" "``org.freedesktop.Platform.GL.Debug`` – Debug extension point for " @@ -611,11 +651,11 @@ msgid "" "to have the debug symbols available." msgstr "" -#: ../../extension.rst:555 +#: ../../extension.rst:586 msgid "The following extensions utilise the above two extension points::" msgstr "" -#: ../../extension.rst:570 +#: ../../extension.rst:601 msgid "" "``org.freedesktop.Platform.VulkanLayer`` – Extension point for `Vulkan " "layers `_." msgstr "" -#: ../../extension.rst:609 +#: ../../extension.rst:653 msgid "" "The application developer needs to explicitly add these extensions in the" " manifest by using ``sdk-extensions`` when building an app." msgstr "" -#: ../../extension.rst:612 +#: ../../extension.rst:656 msgid "" "Extensions marked as ``Compat`` in the name or ``GL32`` provide compat " "support for extra architectures and needs to explicitly requested." msgstr "" -#: ../../extension.rst:615 +#: ../../extension.rst:659 msgid "Additionally all SDKs provide a ``.Docs`` extension for documentation." msgstr "" @@ -845,3 +898,67 @@ msgstr "" #~ "for development tools such as IDEs." #~ msgstr "" +#~ msgid "" +#~ "``org.freedesktop.Platform.ffmpeg-full`` is an " +#~ "application extension (mounted inside " +#~ "``/app/extension_directory``) belonging to " +#~ "``org.freedesktop.Platform``." +#~ msgstr "" + +#~ msgid "" +#~ "``org.freedesktop.Sdk.Extension`` is an extension" +#~ " point defined in ``org.freedesktop.Sdk``." +#~ msgstr "" + +#~ msgid "" +#~ "There is currently no way to " +#~ "`request` autodownload of a runtime " +#~ "extension from an application. The " +#~ "extension point in the runtime has " +#~ "to be set to autodownload or the" +#~ " user has to manually install it." +#~ msgstr "" + +#~ msgid "" +#~ "``sdk-extensions`` can be used to " +#~ "install extra extensions having an " +#~ "extension point in the parent runtime" +#~ " that has to be installed for " +#~ "the app to build. These are " +#~ "similarly made available during build " +#~ "and not in the final flatpak." +#~ msgstr "" + +#~ msgid "" +#~ "``org.freedesktop.Platform.VAAPI.Intel`` – Extension " +#~ "providing Intel VAAPI media drivers. " +#~ "This is automatically installed if the" +#~ " user has an Intel GPU." +#~ msgstr "" + +#~ msgid "" +#~ "This has a compat i386 extension " +#~ "``org.freedesktop.Platform.VAAPI.Intel.i386``." +#~ msgstr "" + +#~ msgid "" +#~ "``org.freedesktop.Platform.openh264`` – Extension " +#~ "providing OpenH264, automatically installed by" +#~ " the runtime." +#~ msgstr "" + +#~ msgid "" +#~ "``org.freedesktop.Platform.ffmpeg`` – Extension " +#~ "providing ffmpeg with support for " +#~ "patented codecs. This needs to " +#~ "explicitly added to the manifest using" +#~ " ``add-extensions`` by the developer, " +#~ "so that it becomes available when " +#~ "the user installs it." +#~ msgstr "" + +#~ msgid "" +#~ "This has a compat i386 extension " +#~ "``org.freedesktop.Platform.ffmpeg_full.i386``." +#~ msgstr "" + diff --git a/po/fr/LC_MESSAGES/manifests.po b/po/fr/LC_MESSAGES/manifests.po index beb685c8..0c005824 100644 --- a/po/fr/LC_MESSAGES/manifests.po +++ b/po/fr/LC_MESSAGES/manifests.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-05 01:10+0530\n" +"POT-Creation-Date: 2025-07-21 08:07+0530\n" "PO-Revision-Date: 2018-05-20 10:37-0400\n" "Last-Translator: Copied by Zanata \n" "Language: fr\n" @@ -17,7 +17,7 @@ msgstr "" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.16.0\n" +"Generated-By: Babel 2.17.0\n" #: ../../manifests.rst:2 msgid "Manifests" @@ -314,7 +314,7 @@ msgid "`meson `_" msgstr "" #: ../../manifests.rst:264 -msgid "`qmake `_" +msgid "`qmake `_" msgstr "" #: ../../manifests.rst:266 @@ -577,3 +577,6 @@ msgstr "" #~ "`_." #~ msgstr "" +#~ msgid "`qmake `_" +#~ msgstr "" + diff --git a/po/ko/LC_MESSAGES/conventions.po b/po/ko/LC_MESSAGES/conventions.po index d8fa854d..14603b77 100644 --- a/po/ko/LC_MESSAGES/conventions.po +++ b/po/ko/LC_MESSAGES/conventions.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-06-30 14:59+0530\n" +"POT-Creation-Date: 2025-07-21 08:07+0530\n" "PO-Revision-Date: 2018-05-20 10:37-0400\n" "Last-Translator: Copied by Zanata \n" "Language: ko\n" @@ -497,7 +497,7 @@ msgstr "" #: ../../conventions.rst:368 msgid "" "Qt: XDG base directories can be accessed with the `QStandardPaths Class " -"`_." +"`_." msgstr "" #: ../../conventions.rst:371 @@ -1134,3 +1134,9 @@ msgstr "" #~ " locations (see :doc:`sandbox-permissions`)." #~ msgstr "" +#~ msgid "" +#~ "Qt: XDG base directories can be " +#~ "accessed with the `QStandardPaths Class " +#~ "`_." +#~ msgstr "" + diff --git a/po/ko/LC_MESSAGES/dotnet.po b/po/ko/LC_MESSAGES/dotnet.po index 6692da79..d3aca094 100644 --- a/po/ko/LC_MESSAGES/dotnet.po +++ b/po/ko/LC_MESSAGES/dotnet.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-09-26 16:32-0300\n" +"POT-Creation-Date: 2025-07-21 08:07+0530\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" @@ -18,7 +18,7 @@ msgstr "" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.16.0\n" +"Generated-By: Babel 2.17.0\n" #: ../../dotnet.rst:2 msgid "Dotnet" @@ -55,64 +55,68 @@ msgid "`GTKSharp `_" msgstr "" #: ../../dotnet.rst:12 +msgid "`Gir.Core `_" +msgstr "" + +#: ../../dotnet.rst:13 msgid "" "The application's source code is hosted on a Git server such as GitHub, " "GitLab, or Bitbucket" msgstr "" -#: ../../dotnet.rst:15 +#: ../../dotnet.rst:16 msgid "Steps for Packaging" msgstr "" -#: ../../dotnet.rst:18 +#: ../../dotnet.rst:19 msgid "Installing Flatpak and Flatpak builder" msgstr "" -#: ../../dotnet.rst:20 +#: ../../dotnet.rst:21 msgid "" "Install Flatpak using the method provided for your distribution `Flatpak " "- Quick Setup `_" msgstr "" -#: ../../dotnet.rst:23 +#: ../../dotnet.rst:24 msgid "" "Install Flatpak Builder through your distribution package manager (e.g. " "``apt`` / ``dnf``)" msgstr "" -#: ../../dotnet.rst:31 +#: ../../dotnet.rst:32 msgid "Creating the Flatpak" msgstr "" -#: ../../dotnet.rst:33 +#: ../../dotnet.rst:34 msgid "" "A few placeholders have been used in the steps below, while going through" " the steps replace these with the ones respective to your project:" msgstr "" -#: ../../dotnet.rst:35 +#: ../../dotnet.rst:36 msgid "" "````: The name of your Flatpak, see :ref:`conventions:application" " ids`." msgstr "" -#: ../../dotnet.rst:36 +#: ../../dotnet.rst:37 msgid "````: The name of the root folder of your app repository" msgstr "" -#: ../../dotnet.rst:37 +#: ../../dotnet.rst:38 msgid "````: The name of your ``.csproj`` file" msgstr "" -#: ../../dotnet.rst:38 +#: ../../dotnet.rst:39 msgid "````: The URL to the git repository of the project" msgstr "" -#: ../../dotnet.rst:40 +#: ../../dotnet.rst:41 msgid "Create a new folder somewhere different from your existing project" msgstr "" -#: ../../dotnet.rst:42 +#: ../../dotnet.rst:43 msgid "" "Create a YAML file titled ``.yaml`` with the following example " "template, replacing the placeholders with the appropriate information. " @@ -120,13 +124,13 @@ msgid "" " in the build paths in this file and subsequent commands as well.):" msgstr "" -#: ../../dotnet.rst:87 +#: ../../dotnet.rst:88 msgid "" "For providing access to other things such as the network or filesystem, " "see :doc:`sandbox-permissions`" msgstr "" -#: ../../dotnet.rst:90 +#: ../../dotnet.rst:91 msgid "" "Copy and save the dotnet NuGet sources generator script ``flatpak-dotnet-" "generator.py`` from the `Flatpak Builder Tools repository " @@ -134,29 +138,29 @@ msgid "" "folder, or run the following command to download it:" msgstr "" -#: ../../dotnet.rst:99 +#: ../../dotnet.rst:100 msgid "Clone down your project repository to the folder" msgstr "" -#: ../../dotnet.rst:105 +#: ../../dotnet.rst:106 msgid "Install dependencies from Flathub" msgstr "" -#: ../../dotnet.rst:111 +#: ../../dotnet.rst:112 msgid "" "Run the NuGet source config generator script ``flatpak-dotnet-" "generator.py`` with the following arguments:" msgstr "" -#: ../../dotnet.rst:117 +#: ../../dotnet.rst:118 msgid "Build and install using Flatpak builder" msgstr "" -#: ../../dotnet.rst:125 +#: ../../dotnet.rst:126 msgid "Testing the build" msgstr "" -#: ../../dotnet.rst:127 +#: ../../dotnet.rst:128 msgid "Run the installed Flatpak application" msgstr "" diff --git a/po/ko/LC_MESSAGES/extension.po b/po/ko/LC_MESSAGES/extension.po index fc698a39..2f35676b 100644 --- a/po/ko/LC_MESSAGES/extension.po +++ b/po/ko/LC_MESSAGES/extension.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-03-13 09:30+0530\n" +"POT-Creation-Date: 2025-07-21 08:07+0530\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" @@ -314,40 +314,79 @@ msgid "" "manifest." msgstr "" -#: ../../extension.rst:211 +#: ../../extension.rst:212 +msgid "Finding Base Runtime Version" +msgstr "" + +#: ../../extension.rst:214 +#, python-brace-format msgid "" -"``org.freedesktop.Platform.ffmpeg-full`` is an application extension " -"(mounted inside ``/app/extension_directory``) belonging to " -"``org.freedesktop.Platform``." +"Some extensions are either built as part of the runtimes or have their " +"extension points defined within them. These typically follow the branch " +"pattern of the runtime. In case of ``org.gnome.{Platform, Sdk}, " +"org.kde.{Platform, Sdk}`` they follow the branch pattern of Freedesktop " +"SDK (``org.freedesktop.{Platform, Sdk}``)." msgstr "" -#: ../../extension.rst:230 +#: ../../extension.rst:220 msgid "" -"``org.freedesktop.Sdk.Extension`` is an extension point defined in " -"``org.freedesktop.Sdk``." +"When using such extensions, the extension version must match the base " +"runtime version. This ensures ABI and API compatibility." msgstr "" -#: ../../extension.rst:247 +#: ../../extension.rst:223 msgid "" -"Note that ``Compat`` or ``GL32`` extensions need to specifically " -"requested. For providing runtime i386 support or for building i386 " -"modules, please refer to :doc:`multiarch`." +"For example, ``org.freedesktop.Platform.ffmpeg-full`` is built as part of" +" the Freedesktop SDK and provides versions ``22.08, 23.08, 24.08, ...``. " +"Suppose the application uses the runtime " +"``org.kde.Platform//5.15-24.08``, which is based on Freedesktop SDK." +msgstr "" + +#: ../../extension.rst:228 +msgid "" +"To find the base runtime version of ``org.kde.Platform//5.15-24.08``, " +"run::" +msgstr "" + +#: ../../extension.rst:234 +msgid "" +"The output will have ``versions=24.08;24.08-extra;1.4``, and thus the " +"base runtime version is of ````org.kde.Platform//5.15-24.08`` is " +"``24.08``." +msgstr "" + +#: ../../extension.rst:238 +msgid "" +"Similarly, for ``org.freedesktop.Sdk.Extension.texlive``, the extension " +"point ``org.freedesktop.Sdk.Extension`` is defined in the Freedesktop " +"SDK. To determine the base runtime version for a derived runtime such as " +"``org.gnome.Platform//48``, run::" msgstr "" -#: ../../extension.rst:251 +#: ../../extension.rst:246 msgid "" -"There is currently no way to `request` autodownload of a runtime " -"extension from an application. The extension point in the runtime has to " -"be set to autodownload or the user has to manually install it." +"The output will have ``versions=24.08``, and thus ``24.08`` needs to be " +"used as ``version`` in ``add-extensions``." +msgstr "" + +#: ../../extension.rst:250 +msgid "Examples" +msgstr "" + +#: ../../extension.rst:281 +msgid "" +"Note that ``Compat`` or ``GL32`` extensions need to specifically " +"requested. For providing runtime i386 support or for building i386 " +"modules, please refer to :doc:`multiarch`." msgstr "" -#: ../../extension.rst:255 +#: ../../extension.rst:285 msgid "" "A few related extension properties can be found in application or runtime" " manifests. These are:" msgstr "" -#: ../../extension.rst:258 +#: ../../extension.rst:288 msgid "" "``inherit-extensions`` can be used to specify an extra set of extension " "points or extensions from the parent runtime or base that is inherited " @@ -358,29 +397,30 @@ msgid "" "it." msgstr "" -#: ../../extension.rst:281 +#: ../../extension.rst:311 msgid "" "``add-build-extensions`` is same as ``add-extensions`` but the extensions" " are made available during build. This can be used to add build " "dependencies that reside in an extension based on the runtime being used." msgstr "" -#: ../../extension.rst:286 +#: ../../extension.rst:316 msgid "" "For example an application using the runtime ``org.freedesktop.Platform``" " can use ``org.freedesktop.Sdk.Extension.openjdk11`` as a build-" "extension." msgstr "" -#: ../../extension.rst:300 +#: ../../extension.rst:330 msgid "" "``sdk-extensions`` can be used to install extra extensions having an " "extension point in the parent runtime that has to be installed for the " "app to build. These are similarly made available during build and not in " -"the final flatpak." +"the final flatpak. These always follow the branch pattern of the base " +"runtime (see above)." msgstr "" -#: ../../extension.rst:315 +#: ../../extension.rst:346 msgid "" "``inherit-sdk-extensions`` is used to inherit extension points from the " "parent SDK into the child SDK. They aren't inherited into the child " @@ -388,51 +428,51 @@ msgid "" "applications." msgstr "" -#: ../../extension.rst:328 +#: ../../extension.rst:359 msgid "" "There is currently no way to add or inherit extensions per-arch. This " "means the extension should be available or made available for all the " "arches used by the application and vice-versa." msgstr "" -#: ../../extension.rst:332 +#: ../../extension.rst:363 msgid "" "This also means that certain extensions like i386 compatibility " "extensions like ``org.freedesktop.Sdk.Compat.i386`` should not be added " "to modules that build for ``aarch64``." msgstr "" -#: ../../extension.rst:337 +#: ../../extension.rst:368 msgid "Extension manifest" msgstr "" -#: ../../extension.rst:339 +#: ../../extension.rst:370 msgid "" "Once the extension point is defined, an extension like " "``org.flatpak.app.plugin.foo`` can be created." msgstr "" -#: ../../extension.rst:342 +#: ../../extension.rst:373 msgid "" "This is a typical example of such an extension manifest. The explanation " "is discussed below." msgstr "" -#: ../../extension.rst:368 +#: ../../extension.rst:399 msgid "``id`` must have the correct prefix of the extension point." msgstr "" -#: ../../extension.rst:369 +#: ../../extension.rst:400 msgid "``branch`` must be the ``version`` declared in the extension point." msgstr "" -#: ../../extension.rst:370 +#: ../../extension.rst:401 msgid "" "``runtime`` should be the ID of the parent module where the extension " "point is defined." msgstr "" -#: ../../extension.rst:372 +#: ../../extension.rst:403 msgid "" "``runtime-version`` is the version of the runtime used by the " "application. If the runtime is built locally and has not specified the " @@ -440,34 +480,34 @@ msgid "" " the value in ``branch`` is used." msgstr "" -#: ../../extension.rst:377 +#: ../../extension.rst:408 msgid "Applications on Flathub usually use either ``stable`` or ``beta``." msgstr "" -#: ../../extension.rst:378 +#: ../../extension.rst:409 msgid "" "``sdk`` should be the same SDK used to build the runtime, followed by its" " version." msgstr "" -#: ../../extension.rst:380 +#: ../../extension.rst:411 msgid "``build-extension: true`` instructs flatpak to build an extension." msgstr "" -#: ../../extension.rst:381 +#: ../../extension.rst:412 msgid "" "``separate-locales: false`` disables creating a ``.Locale`` extension for" " this extension." msgstr "" -#: ../../extension.rst:384 +#: ../../extension.rst:415 msgid "" "Flatpak-builder (>= 1.3.4), can compose metadata for extensions " "automatically and it is no longer required to manually compose them " "through commands in the manifest." msgstr "" -#: ../../extension.rst:388 +#: ../../extension.rst:419 #, python-brace-format msgid "" "In case a manual compose is still required ``appstream-compose " @@ -480,7 +520,7 @@ msgid "" "compose: false`` in the top." msgstr "" -#: ../../extension.rst:393 +#: ../../extension.rst:424 msgid "" "Note that the extension prefix or location of pkg-config files will not " "be in ``$PATH`` or ``$PKG_CONFIG_PATH`` by default. Any such additional " @@ -488,17 +528,17 @@ msgid "" "``prefix`` and ``prepend-*`` properties." msgstr "" -#: ../../extension.rst:398 +#: ../../extension.rst:429 msgid "" "A MetaInfo file should be provided for discoverability in software " "stores. This is a typical example of an extension MetaInfo file." msgstr "" -#: ../../extension.rst:431 +#: ../../extension.rst:462 msgid "Bundled extensions" msgstr "" -#: ../../extension.rst:433 +#: ../../extension.rst:464 msgid "" "Extensions can also be built directly from the application manifest " "instead of creating a separate extension manifest. The ``bundle: true`` " @@ -508,11 +548,11 @@ msgid "" "``directory`` will be exported into that extension." msgstr "" -#: ../../extension.rst:465 +#: ../../extension.rst:496 msgid "Unmaintained Flatpak extensions" msgstr "" -#: ../../extension.rst:467 +#: ../../extension.rst:498 msgid "" "Flatpak also supports `unmaintained extensions` that allows loading " "extensions installed externally into ``/var/lib/flatpak/extension`` and " @@ -522,7 +562,7 @@ msgid "" "the same as above." msgstr "" -#: ../../extension.rst:474 +#: ../../extension.rst:505 msgid "" "An example of an unmaintained extension can be found in browsers such as " "`Chromium " @@ -532,11 +572,11 @@ msgid "" "/firefox-flatpak/runme.sh>`_ on Flathub." msgstr "" -#: ../../extension.rst:479 +#: ../../extension.rst:510 msgid "The Firefox snippet translates to:" msgstr "" -#: ../../extension.rst:490 +#: ../../extension.rst:521 msgid "" "Now the required policy files for Firefox ``pref`` and ``policies.json`` " "can be placed in " @@ -552,34 +592,34 @@ msgid "" " reading policies from ``/app/etc``)" msgstr "" -#: ../../extension.rst:499 +#: ../../extension.rst:530 msgid "" "For details on Chromium, please look at the `readme " "`_." msgstr "" -#: ../../extension.rst:503 +#: ../../extension.rst:534 msgid "Creating an unmaintained Gtk theme extension" msgstr "" -#: ../../extension.rst:505 +#: ../../extension.rst:536 msgid "" "The following script can be used to create an unmaintained extension for " "the host's Gtk 3 theme. This is useful when the theme is not packaged as " "an extension in a remote." msgstr "" -#: ../../extension.rst:509 +#: ../../extension.rst:540 msgid "" "The script expects the theme to be installed in ``/usr/share/themes`` or " "``$XDG_DATA_HOME/themes``." msgstr "" -#: ../../extension.rst:534 +#: ../../extension.rst:565 msgid "Extensions or extension points defined by runtime" msgstr "" -#: ../../extension.rst:536 +#: ../../extension.rst:567 msgid "" "The following extensions and extension points are defined in the " "Freedesktop runtime/SDK or are shipped along with it. Most of these are " @@ -587,11 +627,11 @@ msgid "" "time, please check the respective project." msgstr "" -#: ../../extension.rst:541 +#: ../../extension.rst:572 msgid "These are common to the Freedesktop SDK and runtime:" msgstr "" -#: ../../extension.rst:543 +#: ../../extension.rst:574 #, python-brace-format msgid "" "``org.freedesktop.Platform.GL`` – Extension for graphics drivers managed " @@ -600,7 +640,7 @@ msgid "" " latter containing support for patented codecs." msgstr "" -#: ../../extension.rst:549 +#: ../../extension.rst:580 #, python-brace-format msgid "" "``org.freedesktop.Platform.GL.Debug`` – Debug extension point for " @@ -611,11 +651,11 @@ msgid "" "to have the debug symbols available." msgstr "" -#: ../../extension.rst:555 +#: ../../extension.rst:586 msgid "The following extensions utilise the above two extension points::" msgstr "" -#: ../../extension.rst:570 +#: ../../extension.rst:601 msgid "" "``org.freedesktop.Platform.VulkanLayer`` – Extension point for `Vulkan " "layers `_." msgstr "" -#: ../../extension.rst:609 +#: ../../extension.rst:653 msgid "" "The application developer needs to explicitly add these extensions in the" " manifest by using ``sdk-extensions`` when building an app." msgstr "" -#: ../../extension.rst:612 +#: ../../extension.rst:656 msgid "" "Extensions marked as ``Compat`` in the name or ``GL32`` provide compat " "support for extra architectures and needs to explicitly requested." msgstr "" -#: ../../extension.rst:615 +#: ../../extension.rst:659 msgid "Additionally all SDKs provide a ``.Docs`` extension for documentation." msgstr "" @@ -845,3 +898,67 @@ msgstr "" #~ "for development tools such as IDEs." #~ msgstr "" +#~ msgid "" +#~ "``org.freedesktop.Platform.ffmpeg-full`` is an " +#~ "application extension (mounted inside " +#~ "``/app/extension_directory``) belonging to " +#~ "``org.freedesktop.Platform``." +#~ msgstr "" + +#~ msgid "" +#~ "``org.freedesktop.Sdk.Extension`` is an extension" +#~ " point defined in ``org.freedesktop.Sdk``." +#~ msgstr "" + +#~ msgid "" +#~ "There is currently no way to " +#~ "`request` autodownload of a runtime " +#~ "extension from an application. The " +#~ "extension point in the runtime has " +#~ "to be set to autodownload or the" +#~ " user has to manually install it." +#~ msgstr "" + +#~ msgid "" +#~ "``sdk-extensions`` can be used to " +#~ "install extra extensions having an " +#~ "extension point in the parent runtime" +#~ " that has to be installed for " +#~ "the app to build. These are " +#~ "similarly made available during build " +#~ "and not in the final flatpak." +#~ msgstr "" + +#~ msgid "" +#~ "``org.freedesktop.Platform.VAAPI.Intel`` – Extension " +#~ "providing Intel VAAPI media drivers. " +#~ "This is automatically installed if the" +#~ " user has an Intel GPU." +#~ msgstr "" + +#~ msgid "" +#~ "This has a compat i386 extension " +#~ "``org.freedesktop.Platform.VAAPI.Intel.i386``." +#~ msgstr "" + +#~ msgid "" +#~ "``org.freedesktop.Platform.openh264`` – Extension " +#~ "providing OpenH264, automatically installed by" +#~ " the runtime." +#~ msgstr "" + +#~ msgid "" +#~ "``org.freedesktop.Platform.ffmpeg`` – Extension " +#~ "providing ffmpeg with support for " +#~ "patented codecs. This needs to " +#~ "explicitly added to the manifest using" +#~ " ``add-extensions`` by the developer, " +#~ "so that it becomes available when " +#~ "the user installs it." +#~ msgstr "" + +#~ msgid "" +#~ "This has a compat i386 extension " +#~ "``org.freedesktop.Platform.ffmpeg_full.i386``." +#~ msgstr "" + diff --git a/po/ko/LC_MESSAGES/manifests.po b/po/ko/LC_MESSAGES/manifests.po index f5feaac0..93036a84 100644 --- a/po/ko/LC_MESSAGES/manifests.po +++ b/po/ko/LC_MESSAGES/manifests.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-05 01:10+0530\n" +"POT-Creation-Date: 2025-07-21 08:07+0530\n" "PO-Revision-Date: 2018-05-20 10:37-0400\n" "Last-Translator: Copied by Zanata \n" "Language: ko\n" @@ -17,7 +17,7 @@ msgstr "" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.16.0\n" +"Generated-By: Babel 2.17.0\n" #: ../../manifests.rst:2 msgid "Manifests" @@ -321,7 +321,7 @@ msgid "`meson `_" msgstr "" #: ../../manifests.rst:264 -msgid "`qmake `_" +msgid "`qmake `_" msgstr "" #: ../../manifests.rst:266 @@ -583,3 +583,6 @@ msgstr "" #~ "`_." #~ msgstr "" +#~ msgid "`qmake `_" +#~ msgstr "" + diff --git a/po/pt_BR/LC_MESSAGES/conventions.po b/po/pt_BR/LC_MESSAGES/conventions.po index 670be78c..0df59f28 100644 --- a/po/pt_BR/LC_MESSAGES/conventions.po +++ b/po/pt_BR/LC_MESSAGES/conventions.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak \n" "Report-Msgid-Bugs-To: https://github.com/flatpak/flatpak-docs/issues\n" -"POT-Creation-Date: 2025-06-30 14:59+0530\n" +"POT-Creation-Date: 2025-07-21 08:07+0530\n" "PO-Revision-Date: 2023-05-31 14:22-0300\n" "Last-Translator: Rafael Fontenelle \n" "Language: pt_BR\n" @@ -641,7 +641,7 @@ msgstr "" #, fuzzy msgid "" "Qt: XDG base directories can be accessed with the `QStandardPaths Class " -"`_." +"`_." msgstr "" "Qt: fornece acesso aos diretórios base XDG com a `classe QStandardPaths " "`_" diff --git a/po/pt_BR/LC_MESSAGES/dotnet.po b/po/pt_BR/LC_MESSAGES/dotnet.po index fb2dfa8d..d7cd4aec 100644 --- a/po/pt_BR/LC_MESSAGES/dotnet.po +++ b/po/pt_BR/LC_MESSAGES/dotnet.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-09-26 16:32-0300\n" +"POT-Creation-Date: 2025-07-21 08:07+0530\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: pt_BR\n" @@ -18,7 +18,7 @@ msgstr "" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.16.0\n" +"Generated-By: Babel 2.17.0\n" #: ../../dotnet.rst:2 msgid "Dotnet" @@ -55,64 +55,68 @@ msgid "`GTKSharp `_" msgstr "" #: ../../dotnet.rst:12 +msgid "`Gir.Core `_" +msgstr "" + +#: ../../dotnet.rst:13 msgid "" "The application's source code is hosted on a Git server such as GitHub, " "GitLab, or Bitbucket" msgstr "" -#: ../../dotnet.rst:15 +#: ../../dotnet.rst:16 msgid "Steps for Packaging" msgstr "" -#: ../../dotnet.rst:18 +#: ../../dotnet.rst:19 msgid "Installing Flatpak and Flatpak builder" msgstr "" -#: ../../dotnet.rst:20 +#: ../../dotnet.rst:21 msgid "" "Install Flatpak using the method provided for your distribution `Flatpak " "- Quick Setup `_" msgstr "" -#: ../../dotnet.rst:23 +#: ../../dotnet.rst:24 msgid "" "Install Flatpak Builder through your distribution package manager (e.g. " "``apt`` / ``dnf``)" msgstr "" -#: ../../dotnet.rst:31 +#: ../../dotnet.rst:32 msgid "Creating the Flatpak" msgstr "" -#: ../../dotnet.rst:33 +#: ../../dotnet.rst:34 msgid "" "A few placeholders have been used in the steps below, while going through" " the steps replace these with the ones respective to your project:" msgstr "" -#: ../../dotnet.rst:35 +#: ../../dotnet.rst:36 msgid "" "````: The name of your Flatpak, see :ref:`conventions:application" " ids`." msgstr "" -#: ../../dotnet.rst:36 +#: ../../dotnet.rst:37 msgid "````: The name of the root folder of your app repository" msgstr "" -#: ../../dotnet.rst:37 +#: ../../dotnet.rst:38 msgid "````: The name of your ``.csproj`` file" msgstr "" -#: ../../dotnet.rst:38 +#: ../../dotnet.rst:39 msgid "````: The URL to the git repository of the project" msgstr "" -#: ../../dotnet.rst:40 +#: ../../dotnet.rst:41 msgid "Create a new folder somewhere different from your existing project" msgstr "" -#: ../../dotnet.rst:42 +#: ../../dotnet.rst:43 msgid "" "Create a YAML file titled ``.yaml`` with the following example " "template, replacing the placeholders with the appropriate information. " @@ -120,13 +124,13 @@ msgid "" " in the build paths in this file and subsequent commands as well.):" msgstr "" -#: ../../dotnet.rst:87 +#: ../../dotnet.rst:88 msgid "" "For providing access to other things such as the network or filesystem, " "see :doc:`sandbox-permissions`" msgstr "" -#: ../../dotnet.rst:90 +#: ../../dotnet.rst:91 msgid "" "Copy and save the dotnet NuGet sources generator script ``flatpak-dotnet-" "generator.py`` from the `Flatpak Builder Tools repository " @@ -134,29 +138,29 @@ msgid "" "folder, or run the following command to download it:" msgstr "" -#: ../../dotnet.rst:99 +#: ../../dotnet.rst:100 msgid "Clone down your project repository to the folder" msgstr "" -#: ../../dotnet.rst:105 +#: ../../dotnet.rst:106 msgid "Install dependencies from Flathub" msgstr "" -#: ../../dotnet.rst:111 +#: ../../dotnet.rst:112 msgid "" "Run the NuGet source config generator script ``flatpak-dotnet-" "generator.py`` with the following arguments:" msgstr "" -#: ../../dotnet.rst:117 +#: ../../dotnet.rst:118 msgid "Build and install using Flatpak builder" msgstr "" -#: ../../dotnet.rst:125 +#: ../../dotnet.rst:126 msgid "Testing the build" msgstr "" -#: ../../dotnet.rst:127 +#: ../../dotnet.rst:128 msgid "Run the installed Flatpak application" msgstr "" diff --git a/po/pt_BR/LC_MESSAGES/extension.po b/po/pt_BR/LC_MESSAGES/extension.po index 9f57893b..c449cc11 100644 --- a/po/pt_BR/LC_MESSAGES/extension.po +++ b/po/pt_BR/LC_MESSAGES/extension.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-03-13 09:30+0530\n" +"POT-Creation-Date: 2025-07-21 08:07+0530\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: pt_BR\n" @@ -314,40 +314,79 @@ msgid "" "manifest." msgstr "" -#: ../../extension.rst:211 +#: ../../extension.rst:212 +msgid "Finding Base Runtime Version" +msgstr "" + +#: ../../extension.rst:214 +#, python-brace-format msgid "" -"``org.freedesktop.Platform.ffmpeg-full`` is an application extension " -"(mounted inside ``/app/extension_directory``) belonging to " -"``org.freedesktop.Platform``." +"Some extensions are either built as part of the runtimes or have their " +"extension points defined within them. These typically follow the branch " +"pattern of the runtime. In case of ``org.gnome.{Platform, Sdk}, " +"org.kde.{Platform, Sdk}`` they follow the branch pattern of Freedesktop " +"SDK (``org.freedesktop.{Platform, Sdk}``)." msgstr "" -#: ../../extension.rst:230 +#: ../../extension.rst:220 msgid "" -"``org.freedesktop.Sdk.Extension`` is an extension point defined in " -"``org.freedesktop.Sdk``." +"When using such extensions, the extension version must match the base " +"runtime version. This ensures ABI and API compatibility." msgstr "" -#: ../../extension.rst:247 +#: ../../extension.rst:223 msgid "" -"Note that ``Compat`` or ``GL32`` extensions need to specifically " -"requested. For providing runtime i386 support or for building i386 " -"modules, please refer to :doc:`multiarch`." +"For example, ``org.freedesktop.Platform.ffmpeg-full`` is built as part of" +" the Freedesktop SDK and provides versions ``22.08, 23.08, 24.08, ...``. " +"Suppose the application uses the runtime " +"``org.kde.Platform//5.15-24.08``, which is based on Freedesktop SDK." +msgstr "" + +#: ../../extension.rst:228 +msgid "" +"To find the base runtime version of ``org.kde.Platform//5.15-24.08``, " +"run::" +msgstr "" + +#: ../../extension.rst:234 +msgid "" +"The output will have ``versions=24.08;24.08-extra;1.4``, and thus the " +"base runtime version is of ````org.kde.Platform//5.15-24.08`` is " +"``24.08``." +msgstr "" + +#: ../../extension.rst:238 +msgid "" +"Similarly, for ``org.freedesktop.Sdk.Extension.texlive``, the extension " +"point ``org.freedesktop.Sdk.Extension`` is defined in the Freedesktop " +"SDK. To determine the base runtime version for a derived runtime such as " +"``org.gnome.Platform//48``, run::" msgstr "" -#: ../../extension.rst:251 +#: ../../extension.rst:246 msgid "" -"There is currently no way to `request` autodownload of a runtime " -"extension from an application. The extension point in the runtime has to " -"be set to autodownload or the user has to manually install it." +"The output will have ``versions=24.08``, and thus ``24.08`` needs to be " +"used as ``version`` in ``add-extensions``." +msgstr "" + +#: ../../extension.rst:250 +msgid "Examples" +msgstr "" + +#: ../../extension.rst:281 +msgid "" +"Note that ``Compat`` or ``GL32`` extensions need to specifically " +"requested. For providing runtime i386 support or for building i386 " +"modules, please refer to :doc:`multiarch`." msgstr "" -#: ../../extension.rst:255 +#: ../../extension.rst:285 msgid "" "A few related extension properties can be found in application or runtime" " manifests. These are:" msgstr "" -#: ../../extension.rst:258 +#: ../../extension.rst:288 msgid "" "``inherit-extensions`` can be used to specify an extra set of extension " "points or extensions from the parent runtime or base that is inherited " @@ -358,29 +397,30 @@ msgid "" "it." msgstr "" -#: ../../extension.rst:281 +#: ../../extension.rst:311 msgid "" "``add-build-extensions`` is same as ``add-extensions`` but the extensions" " are made available during build. This can be used to add build " "dependencies that reside in an extension based on the runtime being used." msgstr "" -#: ../../extension.rst:286 +#: ../../extension.rst:316 msgid "" "For example an application using the runtime ``org.freedesktop.Platform``" " can use ``org.freedesktop.Sdk.Extension.openjdk11`` as a build-" "extension." msgstr "" -#: ../../extension.rst:300 +#: ../../extension.rst:330 msgid "" "``sdk-extensions`` can be used to install extra extensions having an " "extension point in the parent runtime that has to be installed for the " "app to build. These are similarly made available during build and not in " -"the final flatpak." +"the final flatpak. These always follow the branch pattern of the base " +"runtime (see above)." msgstr "" -#: ../../extension.rst:315 +#: ../../extension.rst:346 msgid "" "``inherit-sdk-extensions`` is used to inherit extension points from the " "parent SDK into the child SDK. They aren't inherited into the child " @@ -388,51 +428,51 @@ msgid "" "applications." msgstr "" -#: ../../extension.rst:328 +#: ../../extension.rst:359 msgid "" "There is currently no way to add or inherit extensions per-arch. This " "means the extension should be available or made available for all the " "arches used by the application and vice-versa." msgstr "" -#: ../../extension.rst:332 +#: ../../extension.rst:363 msgid "" "This also means that certain extensions like i386 compatibility " "extensions like ``org.freedesktop.Sdk.Compat.i386`` should not be added " "to modules that build for ``aarch64``." msgstr "" -#: ../../extension.rst:337 +#: ../../extension.rst:368 msgid "Extension manifest" msgstr "" -#: ../../extension.rst:339 +#: ../../extension.rst:370 msgid "" "Once the extension point is defined, an extension like " "``org.flatpak.app.plugin.foo`` can be created." msgstr "" -#: ../../extension.rst:342 +#: ../../extension.rst:373 msgid "" "This is a typical example of such an extension manifest. The explanation " "is discussed below." msgstr "" -#: ../../extension.rst:368 +#: ../../extension.rst:399 msgid "``id`` must have the correct prefix of the extension point." msgstr "" -#: ../../extension.rst:369 +#: ../../extension.rst:400 msgid "``branch`` must be the ``version`` declared in the extension point." msgstr "" -#: ../../extension.rst:370 +#: ../../extension.rst:401 msgid "" "``runtime`` should be the ID of the parent module where the extension " "point is defined." msgstr "" -#: ../../extension.rst:372 +#: ../../extension.rst:403 msgid "" "``runtime-version`` is the version of the runtime used by the " "application. If the runtime is built locally and has not specified the " @@ -440,34 +480,34 @@ msgid "" " the value in ``branch`` is used." msgstr "" -#: ../../extension.rst:377 +#: ../../extension.rst:408 msgid "Applications on Flathub usually use either ``stable`` or ``beta``." msgstr "" -#: ../../extension.rst:378 +#: ../../extension.rst:409 msgid "" "``sdk`` should be the same SDK used to build the runtime, followed by its" " version." msgstr "" -#: ../../extension.rst:380 +#: ../../extension.rst:411 msgid "``build-extension: true`` instructs flatpak to build an extension." msgstr "" -#: ../../extension.rst:381 +#: ../../extension.rst:412 msgid "" "``separate-locales: false`` disables creating a ``.Locale`` extension for" " this extension." msgstr "" -#: ../../extension.rst:384 +#: ../../extension.rst:415 msgid "" "Flatpak-builder (>= 1.3.4), can compose metadata for extensions " "automatically and it is no longer required to manually compose them " "through commands in the manifest." msgstr "" -#: ../../extension.rst:388 +#: ../../extension.rst:419 #, python-brace-format msgid "" "In case a manual compose is still required ``appstream-compose " @@ -480,7 +520,7 @@ msgid "" "compose: false`` in the top." msgstr "" -#: ../../extension.rst:393 +#: ../../extension.rst:424 msgid "" "Note that the extension prefix or location of pkg-config files will not " "be in ``$PATH`` or ``$PKG_CONFIG_PATH`` by default. Any such additional " @@ -488,17 +528,17 @@ msgid "" "``prefix`` and ``prepend-*`` properties." msgstr "" -#: ../../extension.rst:398 +#: ../../extension.rst:429 msgid "" "A MetaInfo file should be provided for discoverability in software " "stores. This is a typical example of an extension MetaInfo file." msgstr "" -#: ../../extension.rst:431 +#: ../../extension.rst:462 msgid "Bundled extensions" msgstr "" -#: ../../extension.rst:433 +#: ../../extension.rst:464 msgid "" "Extensions can also be built directly from the application manifest " "instead of creating a separate extension manifest. The ``bundle: true`` " @@ -508,11 +548,11 @@ msgid "" "``directory`` will be exported into that extension." msgstr "" -#: ../../extension.rst:465 +#: ../../extension.rst:496 msgid "Unmaintained Flatpak extensions" msgstr "" -#: ../../extension.rst:467 +#: ../../extension.rst:498 msgid "" "Flatpak also supports `unmaintained extensions` that allows loading " "extensions installed externally into ``/var/lib/flatpak/extension`` and " @@ -522,7 +562,7 @@ msgid "" "the same as above." msgstr "" -#: ../../extension.rst:474 +#: ../../extension.rst:505 msgid "" "An example of an unmaintained extension can be found in browsers such as " "`Chromium " @@ -532,11 +572,11 @@ msgid "" "/firefox-flatpak/runme.sh>`_ on Flathub." msgstr "" -#: ../../extension.rst:479 +#: ../../extension.rst:510 msgid "The Firefox snippet translates to:" msgstr "" -#: ../../extension.rst:490 +#: ../../extension.rst:521 msgid "" "Now the required policy files for Firefox ``pref`` and ``policies.json`` " "can be placed in " @@ -552,34 +592,34 @@ msgid "" " reading policies from ``/app/etc``)" msgstr "" -#: ../../extension.rst:499 +#: ../../extension.rst:530 msgid "" "For details on Chromium, please look at the `readme " "`_." msgstr "" -#: ../../extension.rst:503 +#: ../../extension.rst:534 msgid "Creating an unmaintained Gtk theme extension" msgstr "" -#: ../../extension.rst:505 +#: ../../extension.rst:536 msgid "" "The following script can be used to create an unmaintained extension for " "the host's Gtk 3 theme. This is useful when the theme is not packaged as " "an extension in a remote." msgstr "" -#: ../../extension.rst:509 +#: ../../extension.rst:540 msgid "" "The script expects the theme to be installed in ``/usr/share/themes`` or " "``$XDG_DATA_HOME/themes``." msgstr "" -#: ../../extension.rst:534 +#: ../../extension.rst:565 msgid "Extensions or extension points defined by runtime" msgstr "" -#: ../../extension.rst:536 +#: ../../extension.rst:567 msgid "" "The following extensions and extension points are defined in the " "Freedesktop runtime/SDK or are shipped along with it. Most of these are " @@ -587,11 +627,11 @@ msgid "" "time, please check the respective project." msgstr "" -#: ../../extension.rst:541 +#: ../../extension.rst:572 msgid "These are common to the Freedesktop SDK and runtime:" msgstr "" -#: ../../extension.rst:543 +#: ../../extension.rst:574 #, python-brace-format msgid "" "``org.freedesktop.Platform.GL`` – Extension for graphics drivers managed " @@ -600,7 +640,7 @@ msgid "" " latter containing support for patented codecs." msgstr "" -#: ../../extension.rst:549 +#: ../../extension.rst:580 #, python-brace-format msgid "" "``org.freedesktop.Platform.GL.Debug`` – Debug extension point for " @@ -611,11 +651,11 @@ msgid "" "to have the debug symbols available." msgstr "" -#: ../../extension.rst:555 +#: ../../extension.rst:586 msgid "The following extensions utilise the above two extension points::" msgstr "" -#: ../../extension.rst:570 +#: ../../extension.rst:601 msgid "" "``org.freedesktop.Platform.VulkanLayer`` – Extension point for `Vulkan " "layers `_." msgstr "" -#: ../../extension.rst:609 +#: ../../extension.rst:653 msgid "" "The application developer needs to explicitly add these extensions in the" " manifest by using ``sdk-extensions`` when building an app." msgstr "" -#: ../../extension.rst:612 +#: ../../extension.rst:656 msgid "" "Extensions marked as ``Compat`` in the name or ``GL32`` provide compat " "support for extra architectures and needs to explicitly requested." msgstr "" -#: ../../extension.rst:615 +#: ../../extension.rst:659 msgid "Additionally all SDKs provide a ``.Docs`` extension for documentation." msgstr "" @@ -845,3 +898,67 @@ msgstr "" #~ "for development tools such as IDEs." #~ msgstr "" +#~ msgid "" +#~ "``org.freedesktop.Platform.ffmpeg-full`` is an " +#~ "application extension (mounted inside " +#~ "``/app/extension_directory``) belonging to " +#~ "``org.freedesktop.Platform``." +#~ msgstr "" + +#~ msgid "" +#~ "``org.freedesktop.Sdk.Extension`` is an extension" +#~ " point defined in ``org.freedesktop.Sdk``." +#~ msgstr "" + +#~ msgid "" +#~ "There is currently no way to " +#~ "`request` autodownload of a runtime " +#~ "extension from an application. The " +#~ "extension point in the runtime has " +#~ "to be set to autodownload or the" +#~ " user has to manually install it." +#~ msgstr "" + +#~ msgid "" +#~ "``sdk-extensions`` can be used to " +#~ "install extra extensions having an " +#~ "extension point in the parent runtime" +#~ " that has to be installed for " +#~ "the app to build. These are " +#~ "similarly made available during build " +#~ "and not in the final flatpak." +#~ msgstr "" + +#~ msgid "" +#~ "``org.freedesktop.Platform.VAAPI.Intel`` – Extension " +#~ "providing Intel VAAPI media drivers. " +#~ "This is automatically installed if the" +#~ " user has an Intel GPU." +#~ msgstr "" + +#~ msgid "" +#~ "This has a compat i386 extension " +#~ "``org.freedesktop.Platform.VAAPI.Intel.i386``." +#~ msgstr "" + +#~ msgid "" +#~ "``org.freedesktop.Platform.openh264`` – Extension " +#~ "providing OpenH264, automatically installed by" +#~ " the runtime." +#~ msgstr "" + +#~ msgid "" +#~ "``org.freedesktop.Platform.ffmpeg`` – Extension " +#~ "providing ffmpeg with support for " +#~ "patented codecs. This needs to " +#~ "explicitly added to the manifest using" +#~ " ``add-extensions`` by the developer, " +#~ "so that it becomes available when " +#~ "the user installs it." +#~ msgstr "" + +#~ msgid "" +#~ "This has a compat i386 extension " +#~ "``org.freedesktop.Platform.ffmpeg_full.i386``." +#~ msgstr "" + diff --git a/po/pt_BR/LC_MESSAGES/manifests.po b/po/pt_BR/LC_MESSAGES/manifests.po index 9ac93590..f8fd2cc6 100644 --- a/po/pt_BR/LC_MESSAGES/manifests.po +++ b/po/pt_BR/LC_MESSAGES/manifests.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak \n" "Report-Msgid-Bugs-To: https://github.com/flatpak/flatpak-docs/issues\n" -"POT-Creation-Date: 2025-02-05 01:10+0530\n" +"POT-Creation-Date: 2025-07-21 08:07+0530\n" "PO-Revision-Date: 2022-11-03 12:09-0300\n" "Last-Translator: Rafael Fontenelle \n" "Language: pt_BR\n" @@ -17,7 +17,7 @@ msgstr "" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.16.0\n" +"Generated-By: Babel 2.17.0\n" #: ../../manifests.rst:2 msgid "Manifests" @@ -396,7 +396,8 @@ msgid "`meson `_" msgstr "`meson `_" #: ../../manifests.rst:264 -msgid "`qmake `_" +#, fuzzy +msgid "`qmake `_" msgstr "`qmake `_" #: ../../manifests.rst:266 diff --git a/po/ru/LC_MESSAGES/conventions.po b/po/ru/LC_MESSAGES/conventions.po index 64dd2d36..5c24255c 100644 --- a/po/ru/LC_MESSAGES/conventions.po +++ b/po/ru/LC_MESSAGES/conventions.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: https://github.com/flatpak/flatpak-docs/issues\n" -"POT-Creation-Date: 2025-06-30 14:59+0530\n" +"POT-Creation-Date: 2025-07-21 08:07+0530\n" "PO-Revision-Date: 2023-11-06 21:31+0700\n" "Last-Translator: Dmitry \n" "Language: ru\n" @@ -647,7 +647,7 @@ msgstr "" #, fuzzy msgid "" "Qt: XDG base directories can be accessed with the `QStandardPaths Class " -"`_." +"`_." msgstr "" "Qt: предоставляет доступ к базовым каталогам XDG с помощью QStandardPaths" " `_" diff --git a/po/ru/LC_MESSAGES/dotnet.po b/po/ru/LC_MESSAGES/dotnet.po index 510fa8ce..1489bbfd 100644 --- a/po/ru/LC_MESSAGES/dotnet.po +++ b/po/ru/LC_MESSAGES/dotnet.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-09-26 16:32-0300\n" +"POT-Creation-Date: 2025-07-21 08:07+0530\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ru\n" @@ -19,7 +19,7 @@ msgstr "" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.16.0\n" +"Generated-By: Babel 2.17.0\n" #: ../../dotnet.rst:2 msgid "Dotnet" @@ -56,64 +56,68 @@ msgid "`GTKSharp `_" msgstr "" #: ../../dotnet.rst:12 +msgid "`Gir.Core `_" +msgstr "" + +#: ../../dotnet.rst:13 msgid "" "The application's source code is hosted on a Git server such as GitHub, " "GitLab, or Bitbucket" msgstr "" -#: ../../dotnet.rst:15 +#: ../../dotnet.rst:16 msgid "Steps for Packaging" msgstr "" -#: ../../dotnet.rst:18 +#: ../../dotnet.rst:19 msgid "Installing Flatpak and Flatpak builder" msgstr "" -#: ../../dotnet.rst:20 +#: ../../dotnet.rst:21 msgid "" "Install Flatpak using the method provided for your distribution `Flatpak " "- Quick Setup `_" msgstr "" -#: ../../dotnet.rst:23 +#: ../../dotnet.rst:24 msgid "" "Install Flatpak Builder through your distribution package manager (e.g. " "``apt`` / ``dnf``)" msgstr "" -#: ../../dotnet.rst:31 +#: ../../dotnet.rst:32 msgid "Creating the Flatpak" msgstr "" -#: ../../dotnet.rst:33 +#: ../../dotnet.rst:34 msgid "" "A few placeholders have been used in the steps below, while going through" " the steps replace these with the ones respective to your project:" msgstr "" -#: ../../dotnet.rst:35 +#: ../../dotnet.rst:36 msgid "" "````: The name of your Flatpak, see :ref:`conventions:application" " ids`." msgstr "" -#: ../../dotnet.rst:36 +#: ../../dotnet.rst:37 msgid "````: The name of the root folder of your app repository" msgstr "" -#: ../../dotnet.rst:37 +#: ../../dotnet.rst:38 msgid "````: The name of your ``.csproj`` file" msgstr "" -#: ../../dotnet.rst:38 +#: ../../dotnet.rst:39 msgid "````: The URL to the git repository of the project" msgstr "" -#: ../../dotnet.rst:40 +#: ../../dotnet.rst:41 msgid "Create a new folder somewhere different from your existing project" msgstr "" -#: ../../dotnet.rst:42 +#: ../../dotnet.rst:43 msgid "" "Create a YAML file titled ``.yaml`` with the following example " "template, replacing the placeholders with the appropriate information. " @@ -121,13 +125,13 @@ msgid "" " in the build paths in this file and subsequent commands as well.):" msgstr "" -#: ../../dotnet.rst:87 +#: ../../dotnet.rst:88 msgid "" "For providing access to other things such as the network or filesystem, " "see :doc:`sandbox-permissions`" msgstr "" -#: ../../dotnet.rst:90 +#: ../../dotnet.rst:91 msgid "" "Copy and save the dotnet NuGet sources generator script ``flatpak-dotnet-" "generator.py`` from the `Flatpak Builder Tools repository " @@ -135,29 +139,29 @@ msgid "" "folder, or run the following command to download it:" msgstr "" -#: ../../dotnet.rst:99 +#: ../../dotnet.rst:100 msgid "Clone down your project repository to the folder" msgstr "" -#: ../../dotnet.rst:105 +#: ../../dotnet.rst:106 msgid "Install dependencies from Flathub" msgstr "" -#: ../../dotnet.rst:111 +#: ../../dotnet.rst:112 msgid "" "Run the NuGet source config generator script ``flatpak-dotnet-" "generator.py`` with the following arguments:" msgstr "" -#: ../../dotnet.rst:117 +#: ../../dotnet.rst:118 msgid "Build and install using Flatpak builder" msgstr "" -#: ../../dotnet.rst:125 +#: ../../dotnet.rst:126 msgid "Testing the build" msgstr "" -#: ../../dotnet.rst:127 +#: ../../dotnet.rst:128 msgid "Run the installed Flatpak application" msgstr "" diff --git a/po/ru/LC_MESSAGES/extension.po b/po/ru/LC_MESSAGES/extension.po index 859537a8..e6255c37 100644 --- a/po/ru/LC_MESSAGES/extension.po +++ b/po/ru/LC_MESSAGES/extension.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-03-13 09:30+0530\n" +"POT-Creation-Date: 2025-07-21 08:07+0530\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ru\n" @@ -315,40 +315,79 @@ msgid "" "manifest." msgstr "" -#: ../../extension.rst:211 +#: ../../extension.rst:212 +msgid "Finding Base Runtime Version" +msgstr "" + +#: ../../extension.rst:214 +#, python-brace-format msgid "" -"``org.freedesktop.Platform.ffmpeg-full`` is an application extension " -"(mounted inside ``/app/extension_directory``) belonging to " -"``org.freedesktop.Platform``." +"Some extensions are either built as part of the runtimes or have their " +"extension points defined within them. These typically follow the branch " +"pattern of the runtime. In case of ``org.gnome.{Platform, Sdk}, " +"org.kde.{Platform, Sdk}`` they follow the branch pattern of Freedesktop " +"SDK (``org.freedesktop.{Platform, Sdk}``)." msgstr "" -#: ../../extension.rst:230 +#: ../../extension.rst:220 msgid "" -"``org.freedesktop.Sdk.Extension`` is an extension point defined in " -"``org.freedesktop.Sdk``." +"When using such extensions, the extension version must match the base " +"runtime version. This ensures ABI and API compatibility." msgstr "" -#: ../../extension.rst:247 +#: ../../extension.rst:223 msgid "" -"Note that ``Compat`` or ``GL32`` extensions need to specifically " -"requested. For providing runtime i386 support or for building i386 " -"modules, please refer to :doc:`multiarch`." +"For example, ``org.freedesktop.Platform.ffmpeg-full`` is built as part of" +" the Freedesktop SDK and provides versions ``22.08, 23.08, 24.08, ...``. " +"Suppose the application uses the runtime " +"``org.kde.Platform//5.15-24.08``, which is based on Freedesktop SDK." +msgstr "" + +#: ../../extension.rst:228 +msgid "" +"To find the base runtime version of ``org.kde.Platform//5.15-24.08``, " +"run::" +msgstr "" + +#: ../../extension.rst:234 +msgid "" +"The output will have ``versions=24.08;24.08-extra;1.4``, and thus the " +"base runtime version is of ````org.kde.Platform//5.15-24.08`` is " +"``24.08``." +msgstr "" + +#: ../../extension.rst:238 +msgid "" +"Similarly, for ``org.freedesktop.Sdk.Extension.texlive``, the extension " +"point ``org.freedesktop.Sdk.Extension`` is defined in the Freedesktop " +"SDK. To determine the base runtime version for a derived runtime such as " +"``org.gnome.Platform//48``, run::" msgstr "" -#: ../../extension.rst:251 +#: ../../extension.rst:246 msgid "" -"There is currently no way to `request` autodownload of a runtime " -"extension from an application. The extension point in the runtime has to " -"be set to autodownload or the user has to manually install it." +"The output will have ``versions=24.08``, and thus ``24.08`` needs to be " +"used as ``version`` in ``add-extensions``." +msgstr "" + +#: ../../extension.rst:250 +msgid "Examples" +msgstr "" + +#: ../../extension.rst:281 +msgid "" +"Note that ``Compat`` or ``GL32`` extensions need to specifically " +"requested. For providing runtime i386 support or for building i386 " +"modules, please refer to :doc:`multiarch`." msgstr "" -#: ../../extension.rst:255 +#: ../../extension.rst:285 msgid "" "A few related extension properties can be found in application or runtime" " manifests. These are:" msgstr "" -#: ../../extension.rst:258 +#: ../../extension.rst:288 msgid "" "``inherit-extensions`` can be used to specify an extra set of extension " "points or extensions from the parent runtime or base that is inherited " @@ -359,29 +398,30 @@ msgid "" "it." msgstr "" -#: ../../extension.rst:281 +#: ../../extension.rst:311 msgid "" "``add-build-extensions`` is same as ``add-extensions`` but the extensions" " are made available during build. This can be used to add build " "dependencies that reside in an extension based on the runtime being used." msgstr "" -#: ../../extension.rst:286 +#: ../../extension.rst:316 msgid "" "For example an application using the runtime ``org.freedesktop.Platform``" " can use ``org.freedesktop.Sdk.Extension.openjdk11`` as a build-" "extension." msgstr "" -#: ../../extension.rst:300 +#: ../../extension.rst:330 msgid "" "``sdk-extensions`` can be used to install extra extensions having an " "extension point in the parent runtime that has to be installed for the " "app to build. These are similarly made available during build and not in " -"the final flatpak." +"the final flatpak. These always follow the branch pattern of the base " +"runtime (see above)." msgstr "" -#: ../../extension.rst:315 +#: ../../extension.rst:346 msgid "" "``inherit-sdk-extensions`` is used to inherit extension points from the " "parent SDK into the child SDK. They aren't inherited into the child " @@ -389,51 +429,51 @@ msgid "" "applications." msgstr "" -#: ../../extension.rst:328 +#: ../../extension.rst:359 msgid "" "There is currently no way to add or inherit extensions per-arch. This " "means the extension should be available or made available for all the " "arches used by the application and vice-versa." msgstr "" -#: ../../extension.rst:332 +#: ../../extension.rst:363 msgid "" "This also means that certain extensions like i386 compatibility " "extensions like ``org.freedesktop.Sdk.Compat.i386`` should not be added " "to modules that build for ``aarch64``." msgstr "" -#: ../../extension.rst:337 +#: ../../extension.rst:368 msgid "Extension manifest" msgstr "" -#: ../../extension.rst:339 +#: ../../extension.rst:370 msgid "" "Once the extension point is defined, an extension like " "``org.flatpak.app.plugin.foo`` can be created." msgstr "" -#: ../../extension.rst:342 +#: ../../extension.rst:373 msgid "" "This is a typical example of such an extension manifest. The explanation " "is discussed below." msgstr "" -#: ../../extension.rst:368 +#: ../../extension.rst:399 msgid "``id`` must have the correct prefix of the extension point." msgstr "" -#: ../../extension.rst:369 +#: ../../extension.rst:400 msgid "``branch`` must be the ``version`` declared in the extension point." msgstr "" -#: ../../extension.rst:370 +#: ../../extension.rst:401 msgid "" "``runtime`` should be the ID of the parent module where the extension " "point is defined." msgstr "" -#: ../../extension.rst:372 +#: ../../extension.rst:403 msgid "" "``runtime-version`` is the version of the runtime used by the " "application. If the runtime is built locally and has not specified the " @@ -441,34 +481,34 @@ msgid "" " the value in ``branch`` is used." msgstr "" -#: ../../extension.rst:377 +#: ../../extension.rst:408 msgid "Applications on Flathub usually use either ``stable`` or ``beta``." msgstr "" -#: ../../extension.rst:378 +#: ../../extension.rst:409 msgid "" "``sdk`` should be the same SDK used to build the runtime, followed by its" " version." msgstr "" -#: ../../extension.rst:380 +#: ../../extension.rst:411 msgid "``build-extension: true`` instructs flatpak to build an extension." msgstr "" -#: ../../extension.rst:381 +#: ../../extension.rst:412 msgid "" "``separate-locales: false`` disables creating a ``.Locale`` extension for" " this extension." msgstr "" -#: ../../extension.rst:384 +#: ../../extension.rst:415 msgid "" "Flatpak-builder (>= 1.3.4), can compose metadata for extensions " "automatically and it is no longer required to manually compose them " "through commands in the manifest." msgstr "" -#: ../../extension.rst:388 +#: ../../extension.rst:419 #, python-brace-format msgid "" "In case a manual compose is still required ``appstream-compose " @@ -481,7 +521,7 @@ msgid "" "compose: false`` in the top." msgstr "" -#: ../../extension.rst:393 +#: ../../extension.rst:424 msgid "" "Note that the extension prefix or location of pkg-config files will not " "be in ``$PATH`` or ``$PKG_CONFIG_PATH`` by default. Any such additional " @@ -489,17 +529,17 @@ msgid "" "``prefix`` and ``prepend-*`` properties." msgstr "" -#: ../../extension.rst:398 +#: ../../extension.rst:429 msgid "" "A MetaInfo file should be provided for discoverability in software " "stores. This is a typical example of an extension MetaInfo file." msgstr "" -#: ../../extension.rst:431 +#: ../../extension.rst:462 msgid "Bundled extensions" msgstr "" -#: ../../extension.rst:433 +#: ../../extension.rst:464 msgid "" "Extensions can also be built directly from the application manifest " "instead of creating a separate extension manifest. The ``bundle: true`` " @@ -509,11 +549,11 @@ msgid "" "``directory`` will be exported into that extension." msgstr "" -#: ../../extension.rst:465 +#: ../../extension.rst:496 msgid "Unmaintained Flatpak extensions" msgstr "" -#: ../../extension.rst:467 +#: ../../extension.rst:498 msgid "" "Flatpak also supports `unmaintained extensions` that allows loading " "extensions installed externally into ``/var/lib/flatpak/extension`` and " @@ -523,7 +563,7 @@ msgid "" "the same as above." msgstr "" -#: ../../extension.rst:474 +#: ../../extension.rst:505 msgid "" "An example of an unmaintained extension can be found in browsers such as " "`Chromium " @@ -533,11 +573,11 @@ msgid "" "/firefox-flatpak/runme.sh>`_ on Flathub." msgstr "" -#: ../../extension.rst:479 +#: ../../extension.rst:510 msgid "The Firefox snippet translates to:" msgstr "" -#: ../../extension.rst:490 +#: ../../extension.rst:521 msgid "" "Now the required policy files for Firefox ``pref`` and ``policies.json`` " "can be placed in " @@ -553,34 +593,34 @@ msgid "" " reading policies from ``/app/etc``)" msgstr "" -#: ../../extension.rst:499 +#: ../../extension.rst:530 msgid "" "For details on Chromium, please look at the `readme " "`_." msgstr "" -#: ../../extension.rst:503 +#: ../../extension.rst:534 msgid "Creating an unmaintained Gtk theme extension" msgstr "" -#: ../../extension.rst:505 +#: ../../extension.rst:536 msgid "" "The following script can be used to create an unmaintained extension for " "the host's Gtk 3 theme. This is useful when the theme is not packaged as " "an extension in a remote." msgstr "" -#: ../../extension.rst:509 +#: ../../extension.rst:540 msgid "" "The script expects the theme to be installed in ``/usr/share/themes`` or " "``$XDG_DATA_HOME/themes``." msgstr "" -#: ../../extension.rst:534 +#: ../../extension.rst:565 msgid "Extensions or extension points defined by runtime" msgstr "" -#: ../../extension.rst:536 +#: ../../extension.rst:567 msgid "" "The following extensions and extension points are defined in the " "Freedesktop runtime/SDK or are shipped along with it. Most of these are " @@ -588,11 +628,11 @@ msgid "" "time, please check the respective project." msgstr "" -#: ../../extension.rst:541 +#: ../../extension.rst:572 msgid "These are common to the Freedesktop SDK and runtime:" msgstr "" -#: ../../extension.rst:543 +#: ../../extension.rst:574 #, python-brace-format msgid "" "``org.freedesktop.Platform.GL`` – Extension for graphics drivers managed " @@ -601,7 +641,7 @@ msgid "" " latter containing support for patented codecs." msgstr "" -#: ../../extension.rst:549 +#: ../../extension.rst:580 #, python-brace-format msgid "" "``org.freedesktop.Platform.GL.Debug`` – Debug extension point for " @@ -612,11 +652,11 @@ msgid "" "to have the debug symbols available." msgstr "" -#: ../../extension.rst:555 +#: ../../extension.rst:586 msgid "The following extensions utilise the above two extension points::" msgstr "" -#: ../../extension.rst:570 +#: ../../extension.rst:601 msgid "" "``org.freedesktop.Platform.VulkanLayer`` – Extension point for `Vulkan " "layers `_." msgstr "" -#: ../../extension.rst:609 +#: ../../extension.rst:653 msgid "" "The application developer needs to explicitly add these extensions in the" " manifest by using ``sdk-extensions`` when building an app." msgstr "" -#: ../../extension.rst:612 +#: ../../extension.rst:656 msgid "" "Extensions marked as ``Compat`` in the name or ``GL32`` provide compat " "support for extra architectures and needs to explicitly requested." msgstr "" -#: ../../extension.rst:615 +#: ../../extension.rst:659 msgid "Additionally all SDKs provide a ``.Docs`` extension for documentation." msgstr "" @@ -846,3 +899,67 @@ msgstr "" #~ "for development tools such as IDEs." #~ msgstr "" +#~ msgid "" +#~ "``org.freedesktop.Platform.ffmpeg-full`` is an " +#~ "application extension (mounted inside " +#~ "``/app/extension_directory``) belonging to " +#~ "``org.freedesktop.Platform``." +#~ msgstr "" + +#~ msgid "" +#~ "``org.freedesktop.Sdk.Extension`` is an extension" +#~ " point defined in ``org.freedesktop.Sdk``." +#~ msgstr "" + +#~ msgid "" +#~ "There is currently no way to " +#~ "`request` autodownload of a runtime " +#~ "extension from an application. The " +#~ "extension point in the runtime has " +#~ "to be set to autodownload or the" +#~ " user has to manually install it." +#~ msgstr "" + +#~ msgid "" +#~ "``sdk-extensions`` can be used to " +#~ "install extra extensions having an " +#~ "extension point in the parent runtime" +#~ " that has to be installed for " +#~ "the app to build. These are " +#~ "similarly made available during build " +#~ "and not in the final flatpak." +#~ msgstr "" + +#~ msgid "" +#~ "``org.freedesktop.Platform.VAAPI.Intel`` – Extension " +#~ "providing Intel VAAPI media drivers. " +#~ "This is automatically installed if the" +#~ " user has an Intel GPU." +#~ msgstr "" + +#~ msgid "" +#~ "This has a compat i386 extension " +#~ "``org.freedesktop.Platform.VAAPI.Intel.i386``." +#~ msgstr "" + +#~ msgid "" +#~ "``org.freedesktop.Platform.openh264`` – Extension " +#~ "providing OpenH264, automatically installed by" +#~ " the runtime." +#~ msgstr "" + +#~ msgid "" +#~ "``org.freedesktop.Platform.ffmpeg`` – Extension " +#~ "providing ffmpeg with support for " +#~ "patented codecs. This needs to " +#~ "explicitly added to the manifest using" +#~ " ``add-extensions`` by the developer, " +#~ "so that it becomes available when " +#~ "the user installs it." +#~ msgstr "" + +#~ msgid "" +#~ "This has a compat i386 extension " +#~ "``org.freedesktop.Platform.ffmpeg_full.i386``." +#~ msgstr "" + diff --git a/po/ru/LC_MESSAGES/manifests.po b/po/ru/LC_MESSAGES/manifests.po index 39b1d9bc..d2a8307e 100644 --- a/po/ru/LC_MESSAGES/manifests.po +++ b/po/ru/LC_MESSAGES/manifests.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: https://github.com/flatpak/flatpak-docs/issues\n" -"POT-Creation-Date: 2025-02-05 01:10+0530\n" +"POT-Creation-Date: 2025-07-21 08:07+0530\n" "PO-Revision-Date: 2023-11-06 21:35+0700\n" "Last-Translator: Dmitry \n" "Language: ru\n" @@ -18,7 +18,7 @@ msgstr "" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.16.0\n" +"Generated-By: Babel 2.17.0\n" #: ../../manifests.rst:2 msgid "Manifests" @@ -397,7 +397,8 @@ msgid "`meson `_" msgstr "`meson `_" #: ../../manifests.rst:264 -msgid "`qmake `_" +#, fuzzy +msgid "`qmake `_" msgstr "`qmake `_" #: ../../manifests.rst:266 diff --git a/po/zh_CN/LC_MESSAGES/conventions.po b/po/zh_CN/LC_MESSAGES/conventions.po index ee4d16b5..9ae3a2e3 100644 --- a/po/zh_CN/LC_MESSAGES/conventions.po +++ b/po/zh_CN/LC_MESSAGES/conventions.po @@ -5,7 +5,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-06-30 14:59+0530\n" +"POT-Creation-Date: 2025-07-21 08:07+0530\n" "PO-Revision-Date: 2018-11-03 01:31-0400\n" "Last-Translator: PikachuHy \n" "Language: zh_Hans_CN\n" @@ -544,7 +544,7 @@ msgstr "" #, fuzzy msgid "" "Qt: XDG base directories can be accessed with the `QStandardPaths Class " -"`_." +"`_." msgstr "" "Qt: 通过 `QStandardPaths Class " "`_ 访问XDG基本目录" diff --git a/po/zh_CN/LC_MESSAGES/dotnet.po b/po/zh_CN/LC_MESSAGES/dotnet.po index 94c2efc6..b07b38f3 100644 --- a/po/zh_CN/LC_MESSAGES/dotnet.po +++ b/po/zh_CN/LC_MESSAGES/dotnet.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-09-26 16:32-0300\n" +"POT-Creation-Date: 2025-07-21 08:07+0530\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: zh_CN\n" @@ -18,7 +18,7 @@ msgstr "" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.16.0\n" +"Generated-By: Babel 2.17.0\n" #: ../../dotnet.rst:2 msgid "Dotnet" @@ -55,64 +55,68 @@ msgid "`GTKSharp `_" msgstr "" #: ../../dotnet.rst:12 +msgid "`Gir.Core `_" +msgstr "" + +#: ../../dotnet.rst:13 msgid "" "The application's source code is hosted on a Git server such as GitHub, " "GitLab, or Bitbucket" msgstr "" -#: ../../dotnet.rst:15 +#: ../../dotnet.rst:16 msgid "Steps for Packaging" msgstr "" -#: ../../dotnet.rst:18 +#: ../../dotnet.rst:19 msgid "Installing Flatpak and Flatpak builder" msgstr "" -#: ../../dotnet.rst:20 +#: ../../dotnet.rst:21 msgid "" "Install Flatpak using the method provided for your distribution `Flatpak " "- Quick Setup `_" msgstr "" -#: ../../dotnet.rst:23 +#: ../../dotnet.rst:24 msgid "" "Install Flatpak Builder through your distribution package manager (e.g. " "``apt`` / ``dnf``)" msgstr "" -#: ../../dotnet.rst:31 +#: ../../dotnet.rst:32 msgid "Creating the Flatpak" msgstr "" -#: ../../dotnet.rst:33 +#: ../../dotnet.rst:34 msgid "" "A few placeholders have been used in the steps below, while going through" " the steps replace these with the ones respective to your project:" msgstr "" -#: ../../dotnet.rst:35 +#: ../../dotnet.rst:36 msgid "" "````: The name of your Flatpak, see :ref:`conventions:application" " ids`." msgstr "" -#: ../../dotnet.rst:36 +#: ../../dotnet.rst:37 msgid "````: The name of the root folder of your app repository" msgstr "" -#: ../../dotnet.rst:37 +#: ../../dotnet.rst:38 msgid "````: The name of your ``.csproj`` file" msgstr "" -#: ../../dotnet.rst:38 +#: ../../dotnet.rst:39 msgid "````: The URL to the git repository of the project" msgstr "" -#: ../../dotnet.rst:40 +#: ../../dotnet.rst:41 msgid "Create a new folder somewhere different from your existing project" msgstr "" -#: ../../dotnet.rst:42 +#: ../../dotnet.rst:43 msgid "" "Create a YAML file titled ``.yaml`` with the following example " "template, replacing the placeholders with the appropriate information. " @@ -120,13 +124,13 @@ msgid "" " in the build paths in this file and subsequent commands as well.):" msgstr "" -#: ../../dotnet.rst:87 +#: ../../dotnet.rst:88 msgid "" "For providing access to other things such as the network or filesystem, " "see :doc:`sandbox-permissions`" msgstr "" -#: ../../dotnet.rst:90 +#: ../../dotnet.rst:91 msgid "" "Copy and save the dotnet NuGet sources generator script ``flatpak-dotnet-" "generator.py`` from the `Flatpak Builder Tools repository " @@ -134,29 +138,29 @@ msgid "" "folder, or run the following command to download it:" msgstr "" -#: ../../dotnet.rst:99 +#: ../../dotnet.rst:100 msgid "Clone down your project repository to the folder" msgstr "" -#: ../../dotnet.rst:105 +#: ../../dotnet.rst:106 msgid "Install dependencies from Flathub" msgstr "" -#: ../../dotnet.rst:111 +#: ../../dotnet.rst:112 msgid "" "Run the NuGet source config generator script ``flatpak-dotnet-" "generator.py`` with the following arguments:" msgstr "" -#: ../../dotnet.rst:117 +#: ../../dotnet.rst:118 msgid "Build and install using Flatpak builder" msgstr "" -#: ../../dotnet.rst:125 +#: ../../dotnet.rst:126 msgid "Testing the build" msgstr "" -#: ../../dotnet.rst:127 +#: ../../dotnet.rst:128 msgid "Run the installed Flatpak application" msgstr "" diff --git a/po/zh_CN/LC_MESSAGES/extension.po b/po/zh_CN/LC_MESSAGES/extension.po index 034ea4da..bd33eef3 100644 --- a/po/zh_CN/LC_MESSAGES/extension.po +++ b/po/zh_CN/LC_MESSAGES/extension.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-03-13 09:30+0530\n" +"POT-Creation-Date: 2025-07-21 08:07+0530\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: zh_CN\n" @@ -314,40 +314,79 @@ msgid "" "manifest." msgstr "" -#: ../../extension.rst:211 +#: ../../extension.rst:212 +msgid "Finding Base Runtime Version" +msgstr "" + +#: ../../extension.rst:214 +#, python-brace-format msgid "" -"``org.freedesktop.Platform.ffmpeg-full`` is an application extension " -"(mounted inside ``/app/extension_directory``) belonging to " -"``org.freedesktop.Platform``." +"Some extensions are either built as part of the runtimes or have their " +"extension points defined within them. These typically follow the branch " +"pattern of the runtime. In case of ``org.gnome.{Platform, Sdk}, " +"org.kde.{Platform, Sdk}`` they follow the branch pattern of Freedesktop " +"SDK (``org.freedesktop.{Platform, Sdk}``)." msgstr "" -#: ../../extension.rst:230 +#: ../../extension.rst:220 msgid "" -"``org.freedesktop.Sdk.Extension`` is an extension point defined in " -"``org.freedesktop.Sdk``." +"When using such extensions, the extension version must match the base " +"runtime version. This ensures ABI and API compatibility." msgstr "" -#: ../../extension.rst:247 +#: ../../extension.rst:223 msgid "" -"Note that ``Compat`` or ``GL32`` extensions need to specifically " -"requested. For providing runtime i386 support or for building i386 " -"modules, please refer to :doc:`multiarch`." +"For example, ``org.freedesktop.Platform.ffmpeg-full`` is built as part of" +" the Freedesktop SDK and provides versions ``22.08, 23.08, 24.08, ...``. " +"Suppose the application uses the runtime " +"``org.kde.Platform//5.15-24.08``, which is based on Freedesktop SDK." +msgstr "" + +#: ../../extension.rst:228 +msgid "" +"To find the base runtime version of ``org.kde.Platform//5.15-24.08``, " +"run::" +msgstr "" + +#: ../../extension.rst:234 +msgid "" +"The output will have ``versions=24.08;24.08-extra;1.4``, and thus the " +"base runtime version is of ````org.kde.Platform//5.15-24.08`` is " +"``24.08``." +msgstr "" + +#: ../../extension.rst:238 +msgid "" +"Similarly, for ``org.freedesktop.Sdk.Extension.texlive``, the extension " +"point ``org.freedesktop.Sdk.Extension`` is defined in the Freedesktop " +"SDK. To determine the base runtime version for a derived runtime such as " +"``org.gnome.Platform//48``, run::" msgstr "" -#: ../../extension.rst:251 +#: ../../extension.rst:246 msgid "" -"There is currently no way to `request` autodownload of a runtime " -"extension from an application. The extension point in the runtime has to " -"be set to autodownload or the user has to manually install it." +"The output will have ``versions=24.08``, and thus ``24.08`` needs to be " +"used as ``version`` in ``add-extensions``." +msgstr "" + +#: ../../extension.rst:250 +msgid "Examples" +msgstr "" + +#: ../../extension.rst:281 +msgid "" +"Note that ``Compat`` or ``GL32`` extensions need to specifically " +"requested. For providing runtime i386 support or for building i386 " +"modules, please refer to :doc:`multiarch`." msgstr "" -#: ../../extension.rst:255 +#: ../../extension.rst:285 msgid "" "A few related extension properties can be found in application or runtime" " manifests. These are:" msgstr "" -#: ../../extension.rst:258 +#: ../../extension.rst:288 msgid "" "``inherit-extensions`` can be used to specify an extra set of extension " "points or extensions from the parent runtime or base that is inherited " @@ -358,29 +397,30 @@ msgid "" "it." msgstr "" -#: ../../extension.rst:281 +#: ../../extension.rst:311 msgid "" "``add-build-extensions`` is same as ``add-extensions`` but the extensions" " are made available during build. This can be used to add build " "dependencies that reside in an extension based on the runtime being used." msgstr "" -#: ../../extension.rst:286 +#: ../../extension.rst:316 msgid "" "For example an application using the runtime ``org.freedesktop.Platform``" " can use ``org.freedesktop.Sdk.Extension.openjdk11`` as a build-" "extension." msgstr "" -#: ../../extension.rst:300 +#: ../../extension.rst:330 msgid "" "``sdk-extensions`` can be used to install extra extensions having an " "extension point in the parent runtime that has to be installed for the " "app to build. These are similarly made available during build and not in " -"the final flatpak." +"the final flatpak. These always follow the branch pattern of the base " +"runtime (see above)." msgstr "" -#: ../../extension.rst:315 +#: ../../extension.rst:346 msgid "" "``inherit-sdk-extensions`` is used to inherit extension points from the " "parent SDK into the child SDK. They aren't inherited into the child " @@ -388,51 +428,51 @@ msgid "" "applications." msgstr "" -#: ../../extension.rst:328 +#: ../../extension.rst:359 msgid "" "There is currently no way to add or inherit extensions per-arch. This " "means the extension should be available or made available for all the " "arches used by the application and vice-versa." msgstr "" -#: ../../extension.rst:332 +#: ../../extension.rst:363 msgid "" "This also means that certain extensions like i386 compatibility " "extensions like ``org.freedesktop.Sdk.Compat.i386`` should not be added " "to modules that build for ``aarch64``." msgstr "" -#: ../../extension.rst:337 +#: ../../extension.rst:368 msgid "Extension manifest" msgstr "" -#: ../../extension.rst:339 +#: ../../extension.rst:370 msgid "" "Once the extension point is defined, an extension like " "``org.flatpak.app.plugin.foo`` can be created." msgstr "" -#: ../../extension.rst:342 +#: ../../extension.rst:373 msgid "" "This is a typical example of such an extension manifest. The explanation " "is discussed below." msgstr "" -#: ../../extension.rst:368 +#: ../../extension.rst:399 msgid "``id`` must have the correct prefix of the extension point." msgstr "" -#: ../../extension.rst:369 +#: ../../extension.rst:400 msgid "``branch`` must be the ``version`` declared in the extension point." msgstr "" -#: ../../extension.rst:370 +#: ../../extension.rst:401 msgid "" "``runtime`` should be the ID of the parent module where the extension " "point is defined." msgstr "" -#: ../../extension.rst:372 +#: ../../extension.rst:403 msgid "" "``runtime-version`` is the version of the runtime used by the " "application. If the runtime is built locally and has not specified the " @@ -440,34 +480,34 @@ msgid "" " the value in ``branch`` is used." msgstr "" -#: ../../extension.rst:377 +#: ../../extension.rst:408 msgid "Applications on Flathub usually use either ``stable`` or ``beta``." msgstr "" -#: ../../extension.rst:378 +#: ../../extension.rst:409 msgid "" "``sdk`` should be the same SDK used to build the runtime, followed by its" " version." msgstr "" -#: ../../extension.rst:380 +#: ../../extension.rst:411 msgid "``build-extension: true`` instructs flatpak to build an extension." msgstr "" -#: ../../extension.rst:381 +#: ../../extension.rst:412 msgid "" "``separate-locales: false`` disables creating a ``.Locale`` extension for" " this extension." msgstr "" -#: ../../extension.rst:384 +#: ../../extension.rst:415 msgid "" "Flatpak-builder (>= 1.3.4), can compose metadata for extensions " "automatically and it is no longer required to manually compose them " "through commands in the manifest." msgstr "" -#: ../../extension.rst:388 +#: ../../extension.rst:419 #, python-brace-format msgid "" "In case a manual compose is still required ``appstream-compose " @@ -480,7 +520,7 @@ msgid "" "compose: false`` in the top." msgstr "" -#: ../../extension.rst:393 +#: ../../extension.rst:424 msgid "" "Note that the extension prefix or location of pkg-config files will not " "be in ``$PATH`` or ``$PKG_CONFIG_PATH`` by default. Any such additional " @@ -488,17 +528,17 @@ msgid "" "``prefix`` and ``prepend-*`` properties." msgstr "" -#: ../../extension.rst:398 +#: ../../extension.rst:429 msgid "" "A MetaInfo file should be provided for discoverability in software " "stores. This is a typical example of an extension MetaInfo file." msgstr "" -#: ../../extension.rst:431 +#: ../../extension.rst:462 msgid "Bundled extensions" msgstr "" -#: ../../extension.rst:433 +#: ../../extension.rst:464 msgid "" "Extensions can also be built directly from the application manifest " "instead of creating a separate extension manifest. The ``bundle: true`` " @@ -508,11 +548,11 @@ msgid "" "``directory`` will be exported into that extension." msgstr "" -#: ../../extension.rst:465 +#: ../../extension.rst:496 msgid "Unmaintained Flatpak extensions" msgstr "" -#: ../../extension.rst:467 +#: ../../extension.rst:498 msgid "" "Flatpak also supports `unmaintained extensions` that allows loading " "extensions installed externally into ``/var/lib/flatpak/extension`` and " @@ -522,7 +562,7 @@ msgid "" "the same as above." msgstr "" -#: ../../extension.rst:474 +#: ../../extension.rst:505 msgid "" "An example of an unmaintained extension can be found in browsers such as " "`Chromium " @@ -532,11 +572,11 @@ msgid "" "/firefox-flatpak/runme.sh>`_ on Flathub." msgstr "" -#: ../../extension.rst:479 +#: ../../extension.rst:510 msgid "The Firefox snippet translates to:" msgstr "" -#: ../../extension.rst:490 +#: ../../extension.rst:521 msgid "" "Now the required policy files for Firefox ``pref`` and ``policies.json`` " "can be placed in " @@ -552,34 +592,34 @@ msgid "" " reading policies from ``/app/etc``)" msgstr "" -#: ../../extension.rst:499 +#: ../../extension.rst:530 msgid "" "For details on Chromium, please look at the `readme " "`_." msgstr "" -#: ../../extension.rst:503 +#: ../../extension.rst:534 msgid "Creating an unmaintained Gtk theme extension" msgstr "" -#: ../../extension.rst:505 +#: ../../extension.rst:536 msgid "" "The following script can be used to create an unmaintained extension for " "the host's Gtk 3 theme. This is useful when the theme is not packaged as " "an extension in a remote." msgstr "" -#: ../../extension.rst:509 +#: ../../extension.rst:540 msgid "" "The script expects the theme to be installed in ``/usr/share/themes`` or " "``$XDG_DATA_HOME/themes``." msgstr "" -#: ../../extension.rst:534 +#: ../../extension.rst:565 msgid "Extensions or extension points defined by runtime" msgstr "" -#: ../../extension.rst:536 +#: ../../extension.rst:567 msgid "" "The following extensions and extension points are defined in the " "Freedesktop runtime/SDK or are shipped along with it. Most of these are " @@ -587,11 +627,11 @@ msgid "" "time, please check the respective project." msgstr "" -#: ../../extension.rst:541 +#: ../../extension.rst:572 msgid "These are common to the Freedesktop SDK and runtime:" msgstr "" -#: ../../extension.rst:543 +#: ../../extension.rst:574 #, python-brace-format msgid "" "``org.freedesktop.Platform.GL`` – Extension for graphics drivers managed " @@ -600,7 +640,7 @@ msgid "" " latter containing support for patented codecs." msgstr "" -#: ../../extension.rst:549 +#: ../../extension.rst:580 #, python-brace-format msgid "" "``org.freedesktop.Platform.GL.Debug`` – Debug extension point for " @@ -611,11 +651,11 @@ msgid "" "to have the debug symbols available." msgstr "" -#: ../../extension.rst:555 +#: ../../extension.rst:586 msgid "The following extensions utilise the above two extension points::" msgstr "" -#: ../../extension.rst:570 +#: ../../extension.rst:601 msgid "" "``org.freedesktop.Platform.VulkanLayer`` – Extension point for `Vulkan " "layers `_." msgstr "" -#: ../../extension.rst:609 +#: ../../extension.rst:653 msgid "" "The application developer needs to explicitly add these extensions in the" " manifest by using ``sdk-extensions`` when building an app." msgstr "" -#: ../../extension.rst:612 +#: ../../extension.rst:656 msgid "" "Extensions marked as ``Compat`` in the name or ``GL32`` provide compat " "support for extra architectures and needs to explicitly requested." msgstr "" -#: ../../extension.rst:615 +#: ../../extension.rst:659 msgid "Additionally all SDKs provide a ``.Docs`` extension for documentation." msgstr "" @@ -845,3 +898,67 @@ msgstr "" #~ "for development tools such as IDEs." #~ msgstr "" +#~ msgid "" +#~ "``org.freedesktop.Platform.ffmpeg-full`` is an " +#~ "application extension (mounted inside " +#~ "``/app/extension_directory``) belonging to " +#~ "``org.freedesktop.Platform``." +#~ msgstr "" + +#~ msgid "" +#~ "``org.freedesktop.Sdk.Extension`` is an extension" +#~ " point defined in ``org.freedesktop.Sdk``." +#~ msgstr "" + +#~ msgid "" +#~ "There is currently no way to " +#~ "`request` autodownload of a runtime " +#~ "extension from an application. The " +#~ "extension point in the runtime has " +#~ "to be set to autodownload or the" +#~ " user has to manually install it." +#~ msgstr "" + +#~ msgid "" +#~ "``sdk-extensions`` can be used to " +#~ "install extra extensions having an " +#~ "extension point in the parent runtime" +#~ " that has to be installed for " +#~ "the app to build. These are " +#~ "similarly made available during build " +#~ "and not in the final flatpak." +#~ msgstr "" + +#~ msgid "" +#~ "``org.freedesktop.Platform.VAAPI.Intel`` – Extension " +#~ "providing Intel VAAPI media drivers. " +#~ "This is automatically installed if the" +#~ " user has an Intel GPU." +#~ msgstr "" + +#~ msgid "" +#~ "This has a compat i386 extension " +#~ "``org.freedesktop.Platform.VAAPI.Intel.i386``." +#~ msgstr "" + +#~ msgid "" +#~ "``org.freedesktop.Platform.openh264`` – Extension " +#~ "providing OpenH264, automatically installed by" +#~ " the runtime." +#~ msgstr "" + +#~ msgid "" +#~ "``org.freedesktop.Platform.ffmpeg`` – Extension " +#~ "providing ffmpeg with support for " +#~ "patented codecs. This needs to " +#~ "explicitly added to the manifest using" +#~ " ``add-extensions`` by the developer, " +#~ "so that it becomes available when " +#~ "the user installs it." +#~ msgstr "" + +#~ msgid "" +#~ "This has a compat i386 extension " +#~ "``org.freedesktop.Platform.ffmpeg_full.i386``." +#~ msgstr "" + diff --git a/po/zh_CN/LC_MESSAGES/manifests.po b/po/zh_CN/LC_MESSAGES/manifests.po index 52b1f876..5468dd04 100644 --- a/po/zh_CN/LC_MESSAGES/manifests.po +++ b/po/zh_CN/LC_MESSAGES/manifests.po @@ -4,7 +4,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-05 01:10+0530\n" +"POT-Creation-Date: 2025-07-21 08:07+0530\n" "PO-Revision-Date: 2018-11-03 01:52-0400\n" "Last-Translator: PikachuHy \n" "Language: zh_Hans_CN\n" @@ -13,7 +13,7 @@ msgstr "" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.16.0\n" +"Generated-By: Babel 2.17.0\n" #: ../../manifests.rst:2 msgid "Manifests" @@ -344,7 +344,7 @@ msgid "`meson `_" msgstr "`cmake `_" #: ../../manifests.rst:264 -msgid "`qmake `_" +msgid "`qmake `_" msgstr "" #: ../../manifests.rst:266 @@ -520,3 +520,6 @@ msgstr "" #~ "`_." #~ msgstr "" +#~ msgid "`qmake `_" +#~ msgstr "" +