Appimage/ja: Difference between revisions

From NixOS Wiki
FuzzyBot (talk | contribs)
Updating to match new version of source page
Haruki7049 (talk | contribs)
Created page with "この方法では、AppImageファイルを通常のプログラムのように直接呼び出すことができます。"
 
(10 intermediate revisions by 2 users not shown)
Line 4: Line 4:
</div>
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
<span id="Usage"></span>
== Usage ==
== 使い方 ==
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
<span id="Run"></span>
=== Run ===
=== 実行 ===
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
ほとんどのLinuxディストリビューションでは、<code>.AppImage</code>ファイルをダウンロードし、それを実行可能ファイル<code>chmod +x $AppImage</code>にして実行するだけです。ただし、AppImageファイルは通常(常にではないにしても)ハードコードされたパス内の特定のシステムライブラリに依存するため、NixOSではそのままでは機能しません。
On most distros, all one has to do is download the <code>.AppImage</code> file, make it executable <code>chmod +x $AppImage</code>, and execute it. This doesn't work in NixOS out of the box though, as AppImage files usually (if not always) depend on certain system libraries in hardcoded paths.
</div>


<syntaxhighlight lang="shell">
<syntaxhighlight lang="shell">
Line 20: Line 16:
$ appimage-run $AppImageFile
$ appimage-run $AppImageFile
</syntaxhighlight>
</syntaxhighlight>
<div lang="en" dir="ltr" class="mw-content-ltr">
<span id="Packaging"></span>
=== Packaging ===
=== パッケージング ===
</div>
 
[https://nixos.org/manual/nixpkgs/stable/#sec-pkgs-appimageTools nixpkgs manual on wrapping AppImage packages]を参照してください。要するに、AppImageが抽出され、依存関係がnixビルド依存関係として追加されます。
次の例は、AppImageとしても配布されているプログラム、Qubaの派生です。


<div lang="en" dir="ltr" class="mw-content-ltr">
<syntaxhighlight lang="nix">
See the [https://nixos.org/manual/nixpkgs/stable/#sec-pkgs-appimageTools nixpkgs manual on wrapping AppImage packages]. In short, the AppImage is extracted and any dependencies are added as nix build dependencies.
Following example is a derivation for the program Quba, which is also distributed as AppImage.<syntaxhighlight lang="nix">
{
{
   lib,
   lib,
Line 32: Line 28:
   fetchurl,
   fetchurl,
}:
}:
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
let
let
   version = "1.4.0";
   version = "1.4.0";
   pname = "quba";
   pname = "quba";
   name = "${pname}-${version}";
   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";
     url = "https://github.com/ZUGFeRD/quba-viewer/releases/download/v${version}/Quba-${version}.AppImage";
     hash = "sha256-EsTF7W1np5qbQQh3pdqsFe32olvGK3AowGWjqHPEfoM=";
     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
in
appimageTools.wrapType1 {
appimageTools.wrapType1 {
   inherit name src;
   inherit name src;
</div>


  <div lang="en" dir="ltr" class="mw-content-ltr">
extraInstallCommands = ''
extraInstallCommands = ''
     mv $out/bin/${name} $out/bin/${pname}
     mv $out/bin/${name} $out/bin/${pname}
Line 63: Line 51:
     cp -r ${appimageContents}/usr/share/icons $out/share
     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";
     description = "Viewer for electronic invoices";
Line 77: Line 63:
}
}
</syntaxhighlight>
</syntaxhighlight>
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
<span id="Configuration"></span>
== Configuration ==
== 設定 ==
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
<span id="Register_AppImage_files_as_a_binary_type_to_binfmt_misc"></span>
=== Register AppImage files as a binary type to binfmt_misc ===
=== AppImageファイルタイプをバイナリタイプとしてbinfmt_miscに登録する ===
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
<div lang="en" dir="ltr" class="mw-content-ltr">
Line 91: Line 74:
</div>
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
[https://nixos.org/manual/nixos/stable/release-notes#sec-release-24.05-new-services NixOS 24.05]からは、binfmtオプションがあります:
Since [https://nixos.org/manual/nixos/stable/release-notes#sec-release-24.05-new-services NixOS 24.05], there is a binfmt option:
</div>


<syntaxhighlight lang="nixos">
<syntaxhighlight lang="nixos">
Line 102: Line 83:
</syntaxhighlight>
</syntaxhighlight>


<div lang="en" dir="ltr" class="mw-content-ltr">
この方法では、AppImageファイルを通常のプログラムのように直接呼び出すことができます。
This way AppImage files can be invoked directly as if they were normal programs
</div>


[[Category:Software{{#translation:}}]]
[[Category:Software{{#translation:}}]]

Latest revision as of 08:05, 4 November 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.

使い方

実行

ほとんどのLinuxディストリビューションでは、.AppImageファイルをダウンロードし、それを実行可能ファイルchmod +x $AppImageにして実行するだけです。ただし、AppImageファイルは通常(常にではないにしても)ハードコードされたパス内の特定のシステムライブラリに依存するため、NixOSではそのままでは機能しません。

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

パッケージング

nixpkgs manual on wrapping AppImage packagesを参照してください。要するに、AppImageが抽出され、依存関係がnixビルド依存関係として追加されます。 次の例は、AppImageとしても配布されているプログラム、Qubaの派生です。

{
  lib,
  appimageTools,
  fetchurl,
}:

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

設定

AppImageファイルタイプをバイナリタイプとしてbinfmt_miscに登録する

You can tell the Linux kernel to use an interpreter (e.g. appimage-run) when executing certain binary files through the use of binfmt_misc, either by filename extension or magic number matching. Below NixOS configuration registers AppImage files (ELF files with magic number "AI" + 0x02) to be run with appimage-run as interpreter.

NixOS 24.05からは、binfmtオプションがあります:

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

この方法では、AppImageファイルを通常のプログラムのように直接呼び出すことができます。