Yggdrasil

Yggdrasil

ステータスの構築：

このリポジトリには、binarybuilder.jlを使用して、ジュリアパッケージ用のバイナリを構築するためのレシピが含まれています。

貢献

新しいレシピを提供するために、どちらもできます

• BinaryBuilder.run_wizard()を使用します。これは、要求されたすべてのプラットフォームの成功したビルドの後にこのリポジトリにプル要求を自動的に開きます
• テンプレートとして使用して別のビルドレシピをコピーし、このリポジトリに手動プルリクエストを開きます

Yggdrasilは、Julia 1.3.0以降のバージョンを必要とするBinaryBuilder.jlのmasterバージョンを使用してTarballsを構築します。このbinarybuilder.jlバージョンにはv0.1.4と比較していくつかの違いがあり、生成されたビルダーはわずかに異なることに注意してください。 binarybuilder.jl v0.1.4用に書かれたビルダーを寄付することを歓迎しますが、マイナーな調整が必要になる可能性があります。

BuildKite CIは、ビルダーがターボールを正常に生産できることをテストするために使用されます。

プルリクエストを開く前に手動BuildScriptをテストする場合は、Julia 1.3にBinaryBuilder.jlインストールするか、次のリリースと実行中のjulia --color=yes build_tarballs.jl --verbose --debugローカルにインストールすることをお勧めします。 MacOSでは、これを機能させるためにdockerインストールする必要があります。

既存のビルダーのバージョンを更新します

上流パッケージの新しいバージョンのビルドをトリガーするには、必要に応じてビルダーを更新するためのプル要求を開くだけです。これは通常、バージョン番号とソースのみを更新することになります（たとえば、アーカイブのURLとハッシュ、またはGITリポジトリの改訂版）が、場合によってはさらに変更が必要になる場合があります。

生成されたターボールを使用します

JLLパッケージ

BinaryBuilderの最後のバージョンでは、Julia 1.3のArtifacts Systemの配送を利用しています。これは、BinaryBuilderがJulia Packageのdeps/ Folderに配置されたbuild.jlファイルを生成するのではなく、代わりにJuliabinaryWrappers組織内に配置されたJuliaパッケージ全体（口語的には「JLL」パッケージとして知られている）を生成することを意味します。 Yggdrasilへのマージされたプルリクエストにより、これらのラッパーパッケージの新しいバージョンが生成、アップロード、登録され、クライアントのJuliaコードがusing LibFoo_jll単純に呼び出して、 Pkg.build()ステップを必要とせずにバイナリを取得できます。 （もちろん、これはジュリア1.3+の場合にのみ当てはまります）。

ジュリアの開発者は、ライブラリにJLLパッケージを使用することをお勧めします。 BinaryBuilderの文書化を読んで、それらの使用方法を学びます。

Julia Packagesのプル要求の例をいくつか紹介します。JLLパッケージを使用して、事前に構築されたバイナリをユーザーに提供します。

• Cairo.jl
• fftw.jl
• gsl.jl
• gtk.jl
• rsvg.jl

Artifactsシステムの詳細と、Juliaのブログ「PKG + BinaryBuilder -The Next Generation」のこの投稿で再現性がどのように重要であるかをお読みください。

binaryprovider.jl

JLLパッケージに切り替えることが重要な理由について確信してくれることを願っています。ただし、Julia V1.2または以前のバージョンを本当にサポートする必要がある場合は、BinaryProvider.jlを使用し続ける必要があります。前のセクションで説明したように、 build.jlファイルはビルド後に生成されなくなりました。それはjllパッケージには使用されていないため、自分で生成する必要があります。これ： generate_buildjl.jl 。 3つの位置的議論が必要です。

• build_tarballs.jlスクリプトへのパス
• ターボールがアップロードされたリポジトリのowner/name 。省略した場合、これはJuliaBinaryWrappers/BuilderName_jll.jlにデフォルトです
• ターボールがアップロードされたタグ名。省略した場合、これは一般的なレジストリのJLLパッケージの最新バージョンにデフォルトです。レジストリにパッケージのバージョンがない場合、スクリプトは失敗します。

たとえば、ZLIBの最新バージョンのbuild.jlファイルを取得するには、次のコマンドを実行できます。

 julia --color=yes generate_buildjl.jl Z/Zlib/build_tarballs.jl

代わりに、zlib-v1.2.11+6という名前のタグのbuild_tarballs.jlファイルを取得する場合は、コマンドを実行する必要があります

 julia --color=yes generate_buildjl.jl Z/Zlib/build_tarballs.jl JuliaBinaryWrappers/Zlib_jll.jl Zlib-v1.2.11+6

注：生成されたbuild.jlファイルのすべてのProductコンストラクターに最初の引数としてprefixを手動で追加する必要があります。これは、 BinaryBuilder v0.2+とBinaryProviderの間の構文が分岐しているためです。

また、すべての直接および間接依存関係のbuild.jlファイルが必要であることを忘れないでください。

このシステムを使用してライブラリをインストールするパッケージの例をいくつか紹介します。

• ffmpeg.jl;
• mysql.jlは、Julia v1.3+およびbuild.jlスクリプトのJLLパッケージをBinaryProvider.jlで使用して、以前のリリースに使用します。