Appimage/ru: Difference between revisions

Latest revision as of 17:17, 7 October 2025

AppImage - тип монолитных пакетов для приложений Linux. Содержит все зависимости приложения в одном файле, состоящем из исполняемого файла и встроенной файловой системы.

Использование

Запуск

В большинстве дистрибутивов все, что нужно сделать, это загрузить файл .AppImage, сделать его исполняемым chmod +x $AppImage и выполнить его. Однако это не работает в NixOS «из коробки», поскольку файлы AppImage обычно (если не всегда) зависят от определенных библиотек находящихся в жёстко заданных путях.

$ nix-shell -p appimage-run
$ appimage-run $AppImageFile

Создание AppImage

См. руководство Nixpkgs manual on wrapping AppImage packages. Если кратко, AppImage извлекается, а все зависимости добавляются в качестве зависимостей сборки nix. Следующий пример представляет собой производную для программы Quba, которая также распространяется в виде AppImage.

{
  lib,
  appimageTools,
  fetchurl,
}:

let
  version = "1.4.0";
  pname = "quba";

  src = fetchurl {
    url = "https://github.com/ZUGFeRD/quba-viewer/releases/download/v${version}/Quba-${version}.AppImage";
    hash = "sha256-EsTF7W1np5qbQQh3pdqsFe32olvGK3AowGWjqHPEfoM=";
  };

  appimageContents = appimageTools.extractType1 { inherit name src; };
in
appimageTools.wrapType2 rec {
  inherit pname version src;

  extraInstallCommands = ''
    substituteInPlace $out/share/applications/${pname}.desktop \
      --replace-fail 'Exec=AppRun' 'Exec=${meta.mainProgram}'
  '';

  meta = {
    description = "Viewer for electronic invoices";
    homepage = "https://github.com/ZUGFeRD/quba-viewer";
    downloadPage = "https://github.com/ZUGFeRD/quba-viewer/releases";
    license = lib.licenses.asl20;
    sourceProvenance = with lib.sourceTypes; [ binaryNativeCode ];
    maintainers = with lib.maintainers; [ onny ];
    platforms = [ "x86_64-linux" ];
  };
}

Настройка

Зарегистрируйте файлы AppImage как исполняемый тип в binfmt_misc

Вы можете указать ядру Linux использовать интерпретатор (например, appimage-run) при выполнении определенных двоичных файлов через использование binfmt_misc, либо по расширению имени файла, либо по совпадению магических чисел. Приведенная ниже конфигурация NixOS регистрирует файлы AppImage (ELF-файлы с магическим числом "AI" + 0x02) для запуска с помощью appimage-run в качестве интерпретатора.

programs.appimage = {
  enable = true;
  binfmt = true;
};

Таким образом файлы AppImage могут вызываться напрямую, как если бы они были обычными программами

@@ Line 1: / Line 1: @@
 <languages/>
-<div lang="en" dir="ltr" class="mw-content-ltr">
+[https://appimage.org/ AppImage] - тип монолитных пакетов для приложений Linux. Содержит все зависимости приложения в одном файле, состоящем из исполняемого файла и встроенной файловой системы.
-[https://appimage.org/ AppImage] is a monolithic packaging format for linux applications. It contains all dependencies in one file that is composed of an executable with a tacked on filesystem.
-</div>
 <span id="Usage"></span>
@@ Line 10: / Line 8: @@
 === Запуск ===
-<div class="mw-translate-fuzzy">
+В большинстве дистрибутивов все, что нужно сделать, это загрузить файл <code>.AppImage</code>, сделать его исполняемым <code>chmod +x $AppImage</code> и выполнить его. Однако это не работает в NixOS «из коробки», поскольку файлы AppImage обычно (если не всегда) зависят от определенных библиотек находящихся в жёстко заданных путях.
-== Запуск исполняемых файлов AppImage на NixOS  ==
-</div>
 <syntaxhighlight lang="shell">
@@ Line 19: / Line 15: @@
 </syntaxhighlight>
 <span id="Packaging"></span>
-=== Упаковывание AppImage ===
+=== Создание AppImage ===
 <div class="mw-translate-fuzzy">
-См. руководство [https://nixos.org/manual/nixpkgs/stable/#sec-pkgs-appimageTools Nixpkgs manual on wrapping AppImage packages]. Если кратко, AppImage извлекается, а все зависимости добавляются в качестве зависимостей сборки nix.
+См. руководство [https://nixos.org/manual/nixpkgs/stable/#sec-pkgs-appimageTools Nixpkgs manual on wrapping AppImage packages]. Если кратко, AppImage извлекается, а все зависимости добавляются в качестве зависимостей сборки nix. Следующий пример представляет собой производную для программы Quba, которая также распространяется в виде AppImage.
 </div>
-<div lang="en" dir="ltr" class="mw-content-ltr">
+<syntaxhighlight lang="nix">
+{
+  lib,
+  appimageTools,
+  fetchurl,
+}:
 let
    version = "1.4.0";
    pname = "quba";
-  name = "${pname}-${version}";
-</div>
-   <div lang="en" dir="ltr" class="mw-content-ltr">
+   src = fetchurl {
-src = fetchurl {
      url = "https://github.com/ZUGFeRD/quba-viewer/releases/download/v${version}/Quba-${version}.AppImage";
      hash = "sha256-EsTF7W1np5qbQQh3pdqsFe32olvGK3AowGWjqHPEfoM=";
    };
-</div>
-   <div lang="en" dir="ltr" class="mw-content-ltr">
+   appimageContents = appimageTools.extractType1 { inherit name src; };
-appimageContents = appimageTools.extractType1 { inherit name src; };
 in
-appimageTools.wrapType1 {
+appimageTools.wrapType2 rec {
-   inherit name src;
+   inherit pname version src;
-</div>
-   <div lang="en" dir="ltr" class="mw-content-ltr">
+   extraInstallCommands = ''
-extraInstallCommands = ''
-    mv $out/bin/${name} $out/bin/${pname}
-    install -m 444 -D ${appimageContents}/${pname}.desktop -t $out/share/applications
      substituteInPlace $out/share/applications/${pname}.desktop \
-       --replace-fail 'Exec=AppRun' 'Exec=${pname}'
+       --replace-fail 'Exec=AppRun' 'Exec=${meta.mainProgram}'
-    cp -r ${appimageContents}/usr/share/icons $out/share
    '';
-</div>
-   <div lang="en" dir="ltr" class="mw-content-ltr">
+   meta = {
-meta = {
      description = "Viewer for electronic invoices";
      homepage = "https://github.com/ZUGFeRD/quba-viewer";
@@ Line 68: / Line 58: @@
 }
 </syntaxhighlight>
-</div>
 <span id="Configuration"></span>
@@ Line 76: / Line 66: @@
 == Зарегистрируйте файлы AppImage как исполняемый тип в binfmt_misc ==
+<div class="mw-translate-fuzzy">
 Вы можете указать ядру Linux использовать интерпретатор (например, <code>appimage-run</code>) при выполнении определенных двоичных файлов через использование [https://en.wikipedia.org/wiki/Binfmt_misc#External_links binfmt_misc], либо по расширению имени файла, либо по совпадению магических чисел.
 Приведенная ниже конфигурация NixOS регистрирует файлы AppImage (ELF-файлы с магическим числом "AI" + 0x02) для запуска с помощью <code>appimage-run</code> в качестве интерпретатора.
+</div>
-С [https://nixos.org/manual/nixos/stable/release-notes#sec-release-24.05-new-services NixOS 24.05], имеется опция binfmt:
 <syntaxhighlight lang="nixos">
 programs.appimage = {
@@ Line 90: / Line 79: @@
 Таким образом файлы AppImage могут вызываться напрямую, как если бы они были обычными программами
-[[Category:Software{{#translation:}}]]
+[[Category:Software]]