OCaml パッケージガイドライン - 版の履歴

Kgx: 他言語へのリンクを追加

2023-06-28T06:04:18Z

他言語へのリンクを追加

← 古い版		2023年6月28日 (水) 15:04時点における版
2行目:		2行目:
	[[en:OCaml package guidelines]]		[[en:OCaml package guidelines]]
	[[it:OCaml package guidelines]]		[[it:OCaml package guidelines]]
			[[pt:OCaml package guidelines]]
	{{Package Guidelines}}		{{Package Guidelines}}

	[[Wikipedia:OCaml\|OCaml]] で書かれたソフトウェアの [[PKGBUILD]] を作成する方法。		[[Wikipedia:OCaml\|OCaml]] で書かれたソフトウェアの [[PKGBUILD]] を作成する方法。

	==パッケージの命名==		== パッケージの命名 ==

	ライブラリの場合、{{ic\|ocaml-''modulename''}} を使ってください。アプリケーションの場合、プログラムの名前を使ってください。どちらの場合にしても、名前は全て小文字にしてください。		ライブラリの場合、{{ic\|ocaml-''modulename''}} を使ってください。アプリケーションの場合、プログラムの名前を使ってください。どちらの場合にしても、名前は全て小文字にしてください。

	==ファイルの場所==		== ファイルの場所 ==

	=== ライブラリ ===		=== ライブラリ ===
	OCaml のライブラリは {{ic\|/usr/lib/ocaml}} にインストールしてください。{{ic\|/usr/lib/ocaml/site-lib}} を使うのは非推奨です。		OCaml のライブラリは {{ic\|/usr/lib/ocaml}} にインストールしてください。{{ic\|/usr/lib/ocaml/site-lib}} を使うのは非推奨です。

Kgx: /* Dune を使用した PKGBUILD の例 */ リンクを修正

2023-06-28T06:03:30Z

Dune を使用した PKGBUILD の例: リンクを修正

← 古い版		2023年6月28日 (水) 15:03時点における版
47行目:		47行目:
	== Dune を使用した PKGBUILD の例 ==		== Dune を使用した PKGBUILD の例 ==

	[https://dune.build/Dune] は、OCaml プロジェクトでますます使用されるようになっている新しいビルドシステムです。		[https://dune.build/ Dune] は、OCaml プロジェクトでますます使用されるようになっている新しいビルドシステムです。

	注意すべき点の 1 つは、単一のプロジェクトで OPAM/findlib の意味で複数の ''パッケージ'' を構築でき、それぞれが {{ic\|/usr/lib/ocaml/}} に独自のディレクトリを持つということです。例については、{{pkg\|ocaml-cairo}} を参照してください。リリースビルドの場合、すべての ''パッケージ'' を明示的にリストする必要があります。		注意すべき点の 1 つは、単一のプロジェクトで OPAM/findlib の意味で複数の ''パッケージ'' を構築でき、それぞれが {{ic\|/usr/lib/ocaml/}} に独自のディレクトリを持つということです。例については、{{pkg\|ocaml-cairo}} を参照してください。リリースビルドの場合、すべての ''パッケージ'' を明示的にリストする必要があります。

Kgx: プレーンな findlib を使用した PKGBUILD の例を翻訳して追加

2023-06-28T06:02:21Z

プレーンな findlib を使用した PKGBUILD の例を翻訳して追加

← 古い版		2023年6月28日 (水) 15:02時点における版
82行目:		82行目:
	}		}
	}}		}}

			== プレーンな findlib を使用した PKGBUILD の例 ==

			{{bc\|1=
			# Contributor: Your Name <youremail@domain.com>

			pkgname=ocaml-<package name>
			pkgver=4.2
			pkgrel=1
			license=('')
			arch=('x86_64')
			pkgdesc="An OCaml Package"
			url=""
			depends=('ocaml')
			makedepends=('ocaml-findlib')
			source=()
			options=('!strip')
			md5sums=()

			OCAMLFIND_DESTDIR="${pkgdir}$(ocamlfind printconf destdir)"

			build() {
			cd "${srcdir}/${pkgname}-${pkgver}"
			mkdir -p "$OCAMLFIND_DESTDIR"
			./configure --prefix=/usr
			make
			}

			package() {
			cd "${srcdir}/${pkgname}-${pkgver}"
			env DESTDIR="${pkgdir}" \
			OCAMLFIND_DESTDIR="$OCAMLFIND_DESTDIR" \
			make install
			}
			}}

			多くの OCaml パッケージでは、{{ic\|make}} および {{ic\|make install}} に追加のパラメータを渡す必要があることが多いことに注意してください。また、パッケージがバイトコードを生成しない場合は、必ず {{ic\|!strip}} オプションを削除し、アーキテクチャを変更してください。

Kgx: /* サンプル PKGBUILD */ 同期

2023-06-28T06:01:10Z

サンプル PKGBUILD: 同期

← 古い版		2023年6月28日 (水) 15:01時点における版
45行目:		45行目:
	パッケージで何が配布されるのか、パッケージにネイティブのマシンコードとバイトコードが含まれるのかどうか確認するのが肝要です。		パッケージで何が配布されるのか、パッケージにネイティブのマシンコードとバイトコードが含まれるのかどうか確認するのが肝要です。

	== ~~サンプル~~ PKGBUILD ==		== Dune を使用した PKGBUILD の例 ==

			[https://dune.build/Dune] は、OCaml プロジェクトでますます使用されるようになっている新しいビルドシステムです。

			注意すべき点の 1 つは、単一のプロジェクトで OPAM/findlib の意味で複数の ''パッケージ'' を構築でき、それぞれが {{ic\|/usr/lib/ocaml/}} に独自のディレクトリを持つということです。例については、{{pkg\|ocaml-cairo}} を参照してください。リリースビルドの場合、すべての ''パッケージ'' を明示的にリストする必要があります。

	{{bc\|1=		{{bc\|1=
54行目:		58行目:
	pkgrel=1		pkgrel=1
	license=('')		license=('')
	arch=(~~'i686'~~ 'x86_64')		arch=('x86_64')
	pkgdesc="An OCaml Package"		pkgdesc="An OCaml Package"
	url=""		url=""
	depends=('ocaml')		depends=('ocaml')
	makedepends=('~~ocaml-findlib~~')		makedepends=('dune')
	source=()		source=()
	options=('!strip')		options=('!strip')
	~~md5sums~~=()		sha256sums=()

	OCAMLFIND_DESTDIR="${pkgdir}$(ocamlfind printconf destdir)"

	build() {		build() {
	cd "${srcdir}/${pkgname}-${pkgver}"		cd "${srcdir}/${pkgname}-${pkgver}"
			# The "-p" flag is necessary for release builds, see the Dune manpage. Dune will complain if you forget some packages.
	mkdir -p "$OCAMLFIND_DESTDIR"
			dune build -p package1,package1-extension,package2
	./configure --prefix=/usr
	make
	}		}

	package() {		package() {
	cd "${srcdir}/${pkgname}-${pkgver}"		cd "${srcdir}/${pkgname}-${pkgver}"
	~~env~~ DESTDIR="${pkgdir}" \		DESTDIR="${pkgdir}" dune install --prefix "/usr" --libdir "lib/ocaml"

	OCAMLFIND_DESTDIR="$OCAMLFIND_DESTDIR" \
			# Dune installs documentation in /usr/doc, fix that.
	make install
			install -dm755 "${pkgdir}/usr/share/"
			mv "${pkgdir}/usr/doc" "${pkgdir}/usr/share/"
	}		}
	}}		}}

	大抵の OCaml パッケージでは make や make install にパラメータを追加で指定する必要があることを覚えてください。また、パッケージがバイトコードを生成しない場合は'' '!strip' ''オプションを外してアーキテクチャを変更してください。

2016年1月12日 (火) 07:56にKusakataによる

2016-01-12T07:56:37Z

← 古い版		2016年1月12日 (火) 16:56時点における版
1行目:		1行目:
			[[Category:パッケージ開発]]
	~~#redirect~~[[en:OCaml package guidelines]]		[[en:OCaml package guidelines]]
			[[it:OCaml package guidelines]]
			{{Package Guidelines}}

			[[Wikipedia:OCaml\|OCaml]] で書かれたソフトウェアの [[PKGBUILD]] を作成する方法。

			==パッケージの命名==
			ライブラリの場合、{{ic\|ocaml-''modulename''}} を使ってください。アプリケーションの場合、プログラムの名前を使ってください。どちらの場合にしても、名前は全て小文字にしてください。

			==ファイルの場所==
			=== ライブラリ ===
			OCaml のライブラリは {{ic\|/usr/lib/ocaml}} にインストールしてください。{{ic\|/usr/lib/ocaml/site-lib}} を使うのは非推奨です。

			OCaml のライブラリは {{Pkg\|ocaml-findlib}} を使ってインストールします。{{ic\|ocaml-findlib}} にはライブラリを管理しやすくするライブラリメタデータが含まれています。Ocaml ソフトウェアのデファクトスタンダードとして多くのソフトウェアが {{ic\|ocaml-findlib}} を必要とします。

			{{ic\|ocaml-findlib}} はソースアーカイブに含まれている {{ic\|META}} という名前のファイルから必要なデータを抽出します。ファイルが含まれていない場合 Debian, Ubuntu, Fedora などのパッケージからもらってくるか、あるいはメンテナ自身が作成する必要があります。また、ファイルを含めるようにソフトウェアの開発元にリクエストを送って下さい。

			{{ic\|ocaml-findlib}} でパッケージをインストールするときは {{ic\|OCAMLFIND_DESTDIR}} 変数が使われます。詳しくは下の PKGBUILD を参照。

			=== OASIS ===
			OCaml のパッケージは {{ic\|DESTDIR}} を無視して OASIS を使って実行ファイルをインストールします。OASIS で {{ic\|DESTDIR}} が使われないのは仕様です ([https://forge.ocamlcore.org/tracker/?func=detail&atid=294&aid=852&group_id=54 issue #852])。{{ic\|--destdir}} 引数を使って {{ic\|configure}} スクリプトを実行することで {{ic\|DESTDIR}} のような機能を有効にできます:

			{{bc\|<nowiki>build() {
			cd "${srcdir}/${srcname}-${pkgver}"
			./configure --prefix /usr --destdir "$pkgdir"

			# build commands
			}</nowiki>}}

			== OCaml バイトコードとレベル ==

			OCaml は複数の"レベル"でコードを実行することができます。トップコードレベルではコンパイルを行わずに OCaml のコードを解釈し、バイトコードレベルではマシンに依存しないバイトコードが作成され、ネイティブレベルでは (C/C++ と同じように) 機械語のバイナリが作成されます。

			OCaml のパッケージをビルドするときは、ネイティブのマシンコードがコンパイルされるのかバイトコードがコンパイルされるのか、あるいはその両方か確認する必要があります。レベルが違うと様々な状況が生まれ、あるいはパッケージのオプションや依存関係に問題を起こすこともあります。

			バイトコードが生成される場合は PKGBUILD に以下を記述してバイトコードを保護してください:

			options=('!strip')

			パッケージにバイトコードを含まず、バイナリだけを配布する場合、{{ic\|ocaml}} を依存パッケージに指定する必要はありません。ただし、OCaml コンパイラは {{ic\|ocaml}} パッケージに入っているため makedepends には指定する必要があります。パッケージにネイティブコードとバイトコードの両方を含める場合は {{ic\|ocaml}} は依存パッケージでありながら makedepends にも指定する必要があります。

			稀に OCaml のコードがバイトコードとしてのみ配布されていることがあります: コンパイルされていないソースコードしか配布されていない場合に ''arch'' に ''any'' を使うことが推奨されます。ただし多くのライブラリはネイティブコードを配布しています。

			パッケージで何が配布されるのか、パッケージにネイティブのマシンコードとバイトコードが含まれるのかどうか確認するのが肝要です。

			== サンプル PKGBUILD ==

			{{bc\|1=
			# Contributor: Your Name <youremail@domain.com>

			pkgname=ocaml-<package name>
			pkgver=4.2
			pkgrel=1
			license=('')
			arch=('i686' 'x86_64')
			pkgdesc="An OCaml Package"
			url=""
			depends=('ocaml')
			makedepends=('ocaml-findlib')
			source=()
			options=('!strip')
			md5sums=()

			OCAMLFIND_DESTDIR="${pkgdir}$(ocamlfind printconf destdir)"

			build() {
			cd "${srcdir}/${pkgname}-${pkgver}"
			mkdir -p "$OCAMLFIND_DESTDIR"
			./configure --prefix=/usr
			make
			}

			package() {
			cd "${srcdir}/${pkgname}-${pkgver}"
			env DESTDIR="${pkgdir}" \
			OCAMLFIND_DESTDIR="$OCAMLFIND_DESTDIR" \
			make install
			}
			}}

			大抵の OCaml パッケージでは make や make install にパラメータを追加で指定する必要があることを覚えてください。また、パッケージがバイトコードを生成しない場合は'' '!strip' ''オプションを外してアーキテクチャを変更してください。

Kusakata: en:OCaml package guidelinesへの転送ページ

2015-08-10T04:23:17Z

en:OCaml package guidelinesへの転送ページ

新規ページ

#redirect[[en:OCaml package guidelines]]