「Electron パッケージガイドライン」の版間の差分

提供: ArchWiki
ナビゲーションに移動 検索に移動
(ページの作成:「Category:Arch パッケージガイドライン en:Electron package guidelines pt:Electron package guidelines {{Package Guidelines}} このドキュメント…」)
 
 
(2人の利用者による、間の2版が非表示)
8行目: 8行目:
 
== Electron システムを使う ==
  
== Electron システムを使う ==
   
−
Arch Linux には {{Pkg|electron}} と {{Pkg|electron2}} パッケージがあり、これらを使うことでシェルスクリプトのラッパーを介して Electron アプリケーションを実行できます:
 +
Arch Linux には {{Pkg|electron}} と {{AUR|electron2}} パッケージがあり、これらを使うことでシェルスクリプトのラッパーを介して Electron アプリケーションを実行できます:
   
 
{{bc|#!/bin/sh
  
{{bc|#!/bin/sh
33行目: 33行目:
   
 
詳しくは [https://electronjs.org/docs/tutorial/using-native-node-modules こちら] を参照。
  
詳しくは [https://electronjs.org/docs/tutorial/using-native-node-modules こちら] を参照。
  +
  +
=== electron-builder と system electron の併用について ===
  +
  +
多くのプロジェクトでは、Javascript ファイルと Electron バイナリのビルドとパッケージ化に '''electron-builder''' を使用しています。デフォルトでは、electron-builder はパッケージ管理ファイル (例:{{ic|package.json}}) で定義されている electron の全バージョンをダウンロードします。これは、electron バイナリを、システム electron が使うためで、一見、帯域幅を節約したくなりますが、それは望ましくありません。electron-builder は、Electron のカスタムパスとアプリケーションがパッケージされているバージョンをそれぞれ指定するために、{{ic|electronDist}} と {{ic|electronVersion}} のコンフィギュレーションを提供します。
  +
  +
electron-builder の設定ファイル（例:{{ic|electron-builder.json}}）を探して、以下の設定を追加してください。
  +
  +
* {{Pkg|electron}} の場合は {{ic|/usr/lib/electron}} に、{{AUR|electron2}} の場合は {{ic|/usr/lib/electron2}} に設定してください。
  +
* {{ic|electronVersion}} を {{ic|/usr/lib/electron/version}} の内容から、先頭の {{ic|v}} を除いたものに変更します。
  +
  +
これを適用するパッケージ {{AUR|rocketchat-desktop}} {{AUR|ubports-installer-git}}
  +
  +
[https://www.electron.build/configuration/configuration electron-builder 設定]
  +
  +
また、CLI を使用して、以下のように設定を変更・追加することもできます。
  +
  +
./node_modules/.bin/electron-builder --linux --x64 --dir $dist -c.electronDist=$electronDist -c.electronVersion=$electronVer
  +
  +
これらのオプションをすべて指定しないと、動作しないので注意してください。
  +
  +
これを適用するパッケージ {{AUR|deezloader-remix-git}} です。
   
 
== アーキテクチャ ==
  
== アーキテクチャ ==

2022年2月21日 (月) 13:38時点における最新版

パッケージ作成ガイドライン

32ビット – CLR – クロス – Eclipse – Electron – Free Pascal – GNOME – Go – Haskell – Java – KDE – カーネル – Lisp – MinGW – Node.js – ノンフリー – OCaml – Perl – PHP – Python – R – Ruby – Rust – VCS – ウェブ – Wine

このドキュメントでは Electron の PKGBUILD を書く時の標準とガイドラインについて触れています。

Electron システムを使う

Arch Linux には electron と electron2AUR パッケージがあり、これらを使うことでシェルスクリプトのラッパーを介して Electron アプリケーションを実行できます: 

#!/bin/sh

exec electron /path/to/appname/ "$@"

appname/ ディレクトリあるいは appname.asar という名前のファイルバンドルは resources/app/ フォルダ (または resources/app.asar) などのビルド済み Electron アプリケーションとして存在します。他のファイルは全て Electron ランタイムのコピーであり、パッケージからは削除しても問題ありません。

コンパイル済みの拡張をシステムの Electron でビルド

一部の Electron アプリケーションは Electron ランタイムにリンクされたコンパイル済みのネイティブ拡張を含んでおり、適切なバージョンの Electron を使ってビルドする必要があります。npm/yarn は常にビルド済みのプライベートな Electron コピーでビルドしてしまうため、package.json から Electron の依存関係にパッチをあてて、システムの Electron と同じバージョンを使うようにしてください。ビルドシステムは必要なビルド済みコピーをダウンロードして、ネイティブ拡張をコンパイルし、パッケージを作成するので、package() で不要なファイルを削除します。

もしくは、package.json から Electron の依存を削除して、npm の実行前に環境変数を設定することもできます: 

export npm_config_target=$(cat /usr/lib/electron/version | tail -c +2)
export npm_config_arch=x64
export npm_config_target_arch=x64
export npm_config_disturl=https://atom.io/download/electron
export npm_config_runtime=electron
export npm_config_build_from_source=true
HOME="$srcdir/.electron-gyp" npm install

HOME を $srcdir のパスに設定することで、ビルド時に HOME ディレクトリにファイルが作られなくなります。.electron-gyp キャッシュを利用するコマンドのパスは調整してください。

詳しくは こちら を参照。

electron-builder と system electron の併用について

多くのプロジェクトでは、Javascript ファイルと Electron バイナリのビルドとパッケージ化に electron-builder を使用しています。デフォルトでは、electron-builder はパッケージ管理ファイル (例:package.json) で定義されている electron の全バージョンをダウンロードします。これは、electron バイナリを、システム electron が使うためで、一見、帯域幅を節約したくなりますが、それは望ましくありません。electron-builder は、Electron のカスタムパスとアプリケーションがパッケージされているバージョンをそれぞれ指定するために、electronDist と electronVersion のコンフィギュレーションを提供します。

electron-builder の設定ファイル（例:electron-builder.json）を探して、以下の設定を追加してください。

  • electron の場合は /usr/lib/electron に、electron2AUR の場合は /usr/lib/electron2 に設定してください。
  • electronVersion を /usr/lib/electron/version の内容から、先頭の v を除いたものに変更します。

これを適用するパッケージ rocketchat-desktopAUR ubports-installer-gitAUR

electron-builder 設定

また、CLI を使用して、以下のように設定を変更・追加することもできます。 

./node_modules/.bin/electron-builder --linux --x64 --dir $dist -c.electronDist=$electronDist -c.electronVersion=$electronVer

これらのオプションをすべて指定しないと、動作しないので注意してください。

これを適用するパッケージ deezloader-remix-gitAUR です。

アーキテクチャ

PKGBUILD#arch を見てください。

コンパイル済みのネイティブ拡張を含む Electron パッケージはアーキテクチャに依存します。他のパッケージはアーキテクチャに依存しません。

パッケージにビルド済みの Electron のコピーが含まれる場合、常にアーキテクチャに依存しています。

ディレクトリ構造

パッケージがアーキテクチャ依存の場合、resources/app/ ディレクトリを /usr/lib/appname/ にインストールしてください。非依存の場合は /usr/share/appname/ を使ってください。

パッケージにビルド済みの Electron のコピーを含む場合、全て /opt/appname にコピーしてください。

「https://wiki.archlinux.jp/index.php?title=Electron_パッケージガイドライン&oldid=24140」から取得