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 17: / Line 17: @@
 === Создание AppImage ===
+<div class="mw-translate-fuzzy">
 См. руководство [https://nixos.org/manual/nixpkgs/stable/#sec-pkgs-appimageTools Nixpkgs manual on wrapping AppImage packages]. Если кратко, AppImage извлекается, а все зависимости добавляются в качестве зависимостей сборки nix. Следующий пример представляет собой производную для программы Quba, которая также распространяется в виде AppImage.
+</div>
 <syntaxhighlight lang="nix">
@@ Line 29: / Line 31: @@
    version = "1.4.0";
    pname = "quba";
-  name = "${pname}-${version}";
-src = fetchurl {
+  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; };
+  appimageContents = appimageTools.extractType1 { inherit name src; };
 in
-appimageTools.wrapType1 {
+appimageTools.wrapType2 rec {
-   inherit name src;
+   inherit pname version src;
-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
    '';
-meta = {
+  meta = {
      description = "Viewer for electronic invoices";
      homepage = "https://github.com/ZUGFeRD/quba-viewer";
@@ Line 60: / Line 58: @@
 }
 </syntaxhighlight>
 <span id="Configuration"></span>
@@ Line 67: / 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 81: / Line 79: @@
 Таким образом файлы AppImage могут вызываться напрямую, как если бы они были обычными программами
-[[Category:Software{{#translation:}}]]
+[[Category:Software]]