Appimage/ru: Difference between revisions

Revision as of 08:24, 14 August 2024

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.

Usage

В большинстве дистрибутивов все, что нужно сделать, это загрузить файл .AppImage, сделать его исполняемым chmod +x $AppImage и выполнить его. Однако это не работает в NixOS «из коробки», поскольку файлы AppImage обычно (если не всегда) зависят от определенных библиотек, обычно встречающихся в других дистрибутивах Linux, которые существуют на определенных путях; например /lib64/ld-linux-x86-64.so.2.

Запуск исполняемых файлов AppImage на NixOS

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

Как файлы AppImage упаковываются для Nixos

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

let

 version = "1.4.0";
 pname = "quba";
 name = "${pname}-${version}";

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.wrapType1 {

 inherit name src;

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}'
   cp -r ${appimageContents}/usr/share/icons $out/share
 ;

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" ];
 };

} </syntaxhighlight>

Configuration

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

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

С NixOS 24.05, имеется опция binfmt:

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

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

@@ Line 4: / Line 4: @@
 </div>
+<div lang="en" dir="ltr" class="mw-content-ltr">
+== Usage ==
+</div>
+<span id="Run"></span>
+<div class="mw-translate-fuzzy">
 В большинстве дистрибутивов все, что нужно сделать, это загрузить файл <code>.AppImage</code>, сделать его исполняемым <code>chmod +x $AppImage</code> и выполнить его. Однако это не работает в NixOS «из коробки», поскольку файлы AppImage обычно (если не всегда) зависят от определенных библиотек, обычно встречающихся в других дистрибутивах Linux, которые существуют на определенных путях; например <code>/lib64/ld-linux-x86-64.so.2</code>.
+</div>
-<span id="Running_an_AppImage_file_on_NixOS"></span>
+<div class="mw-translate-fuzzy">
 == Запуск исполняемых файлов AppImage на NixOS  ==
+</div>
 <syntaxhighlight lang="shell">
@@ Line 13: / Line 21: @@
 $ appimage-run $AppImageFile
 </syntaxhighlight>
+<span id="Packaging"></span>
+<div class="mw-translate-fuzzy">
+== Как файлы AppImage упаковываются для Nixos ==
+</div>
+<div class="mw-translate-fuzzy">
+См. руководство [https://nixos.org/manual/nixpkgs/stable/#sec-pkgs-appimageTools Nixpkgs manual on wrapping AppImage packages]. Если кратко, AppImage извлекается, а все зависимости добавляются в качестве зависимостей сборки nix.
+</div>
+<div lang="en" dir="ltr" class="mw-content-ltr">
+let
+  version = "1.4.0";
+  pname = "quba";
+  name = "${pname}-${version}";
+</div>
+  <div lang="en" dir="ltr" class="mw-content-ltr">
+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; };
+in
+appimageTools.wrapType1 {
+  inherit name src;
+</div>
+  <div lang="en" dir="ltr" class="mw-content-ltr">
+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}'
+    cp -r ${appimageContents}/usr/share/icons $out/share
+  '';
+</div>
+  <div lang="en" dir="ltr" class="mw-content-ltr">
+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" ];
+  };
+}
+</syntaxhighlight>
+</div>
+<div lang="en" dir="ltr" class="mw-content-ltr">
+== Configuration ==
+</div>
 <span id="Register_AppImage_files_as_a_binary_type_to_binfmt_misc"></span>
+<div class="mw-translate-fuzzy">
 == Зарегистрируйте файлы AppImage как исполняемый тип в binfmt_misc ==
+</div>
 Вы можете указать ядру Linux использовать интерпретатор (например, <code>appimage-run</code>) при выполнении определенных двоичных файлов через использование [https://en.wikipedia.org/wiki/Binfmt_misc#External_links binfmt_misc], либо по расширению имени файла, либо по совпадению магических чисел.
@@ Line 30: / Line 97: @@
 Таким образом файлы AppImage могут вызываться напрямую, как если бы они были обычными программами
-<span id="How_AppImage_files_are_packaged_by_NixOS"></span>
-== Как файлы AppImage упаковываются для Nixos ==
-См. руководство [https://nixos.org/manual/nixpkgs/stable/#sec-pkgs-appimageTools Nixpkgs manual on wrapping AppImage packages]. Если кратко, AppImage извлекается, а все зависимости добавляются в качестве зависимостей сборки nix.
 [[Category:Software{{#translation:}}]]