Lazarus/FPC Libraries/ja: what changed

Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.

Old	New		Line
1	1		このページでは Lazarus/FPC でライブラリを作成しうる方法やプロジェクト、パッケージでそれらを利用する方法を述べます。
2	2
3	3		## 関連項目
4	4
5	5		- [[Creating bindings for C libraries/ja]] - C のヘッダファイル (.h) を Pascal のユニットに変換する方法。
6	6
7	7		## 総論
8	8
9	9		静的ライブラリ: デフォルトでは FPC は静的リンクを用いて実行ファイルをコンパイル・リンクします。即ち、リンカはプロジェクトと各パッケージに含まれる全ての .o ファイルをまとめて一つの大きな実行ファイルにします。利点は外部環境への依存性がないことで、欠点は一台のコンピュータにある複数のプログラムがコードを共有できないことです。また、プラグインをロード／アンロードすることもできません。
10	10
11	11		動的ライブラリ（ダイナミック・ライブラリ）: 動的ライブラリの考え方は、ライブラリをプログラム間で共有することで、コードを格納するメモリ領域を節約し、頻繁に利用されるライブラリでは軌道時間を短縮し、プラグインを可能にしようという発想です。動的ライブラリの欠点は、たまにしか利用されないライブラリでは遅くなること、内部構造が複雑になること（これは主にコンパイラ側の課題です）、初期化の方法が異なること（後述）、互換性のある共有コードだけを混用するための version system が必要になることです。
12	12
13	13		## オペレーティング・システム
14	14
15	15		動的ライブラリ:
16	16
17	17		\| オペレーティング・システム \| 動的ライブラリ \| 静的ライブラリ \|
18	18		\|--------------------------------\|--------------------\|--------------------\|
19	19		\| FreeBSD \| .so \| .a \|
20	20		\| macOS \| .dylib \| .a \|
21	21		\| Linux \| .so \| .a \|
22	22		\| Windows \| .dll \| .lib \|
23	23		\| Haiku \| .so \| .a \|
24	24
25	25		### FreeBSD
26	26
27	27		### macOS
28	28
29	29		### Linux
30	30
31	31		動的ライブラリのファイル名は常に 'lib'+パッケージ名+'.so'+ヴァージョンという形をとります。例えば: libz.so.1 や libz.so.1.2.2。
32	32
33	33		Linux は環境変数 LD_LIBRARY_PATH に従ってライブラリを検索し、次いで /lib、次いで /usr/lib、最後に /etc/ld.so.conf を見ます。
34	34
35	35		Linux 環境下で（FPC で書かれたものではない）他のライブラリとメモリを共有するには（GetMem / FreeMem、string型）、unit cmem を用いる必要があります。メモリ割当を行う他のユニットより先にこのユニットの初期化部が呼び出されるように、このユニットは、プロジェクトの主ソースファイル（典型的には .lpr）の uses 節の先頭におくようにします。
36	36
37	37		### Windows
38	38
39	39		Windows はカレントディレクトリ、システムディレクトリ、環境変数 PATH で指定されたディレクトリを検索します。
40	40
41	41		## ppumove, .ppu, .ppl
42	42
43	43		通常の場合、FPC はユニット毎に .ppu ファイルと .o ファイルを一つづつ生成します。.ppu ファイルは .pas/.pp ファイルの重要な情報（型、.o ファイルなどの必要なファイル名）を全て含んでおり、一方 .o ファイルはアセンブラ・コードと現用のシステム向けに名前修飾された識別子を含んでいます。
44	44
45	45		ツール ppumove は全ての FPC インストールパッケージに含まれており、一つまたは複数の .ppu ないし .o ファイルを単一の動的ライブラリに変換します。この機能ははリンカを呼び出すことで行われます。リンカは全ての .o ファイルを集めて一つの .so ファイル（Windows では .dll、Mac OS X では .dylib）にし、.o ファイルへの参照を .ppu ファイルから取り除きます。このようにして作られた新しい .ppu ファイルは普通 .pplファイルと呼ばれます。
46	46
47	47		例:
48	48
49	49		パッケージの出力ディレクトリ（.ppu ファイルがある）で、
50	50
51		-	~~` ppumove -o packagename -e ppl *.ppu`~~
	51	+	```text
	52	+	ppumove -o packagename -e ppl *.ppu
	53	+	```
52	54
53	55		とすると、全ての .ppu ファイルが .ppl ファイルに変換され、一つのファイルlibpackagename.so （Windowsでは: packagename.dll）が生成されます。Linux では、ライブラリファイルの名前の先頭には必ず 'lib' が付けられることを知っておいてください。
54	56
55	57		こうして生成された新しいライブラリはそのまま C などの他のプログラミング言語から利用することができます。FPC のプログラムからも external 修飾子を付ければ利用することができます。しかし、初期化/終了 initialization/finalization セクションが自動的に呼び出されなければなりません。その過程でヒープマネジャの初期化と終了処理が行われるからです。さもないと string型変数も GetMem も使えません。この点 FPC プログラマは甘やかされており（訳注: 何もしないでも初期化／終了処理が自動実行されるから）、もっといい目にあっているわけです。
56	58
57	59		## dlopen -動的ライブラリのロード
58	60
59	61		動的ライブラリのロードは、dl ユニットの中の dlopen 関数を利用すると簡単にできます。
60	62
61	63		ToDo: 誰か例を付け加えてください
62	64
63	65		主な問題は、ファイル名の取得です。ファイル名はヴァージョンとOSに依存します。
64	66
65	67		## 初期化処理
66	68
67	69		それぞれのユニットに、初期化 initialization セクションを一つ含めることができます。初期化セクションが実行される順序は、uses 節でのユニット記述順に従います。
68	70
69	71		How to initialize a dynamic library: ToDo
70	72
71	73		## 終了処理
72	74
73	75		それぞれのユニットに、終了 finalization セクションを一つ含めることができます。終了セクションが実行される順序は、初期化セクションが実行される順序の逆です。
74	76
75	77		## ヴァージョン、配布
76	78
77	79		ライブラリは時の経過とともに育ち、変わっていくものです。新しい機能を付け加えるのは問題がありませんが、パブリックメソッドを削除したり、引数を変更したりすると、ライブラリの互換性が失われます。そうなると、インストール済のライブラリ (.so, .dll, .dylib) を互換性のあるものと置き換えたり、あるいは新たなライブラリをシステムに追加したりしないとなりません。これが全てのライブラリにヴァージョン番号が必要な理由です。
78	80
79	81		dl ユニットの中の dlopen 関数を用いて動的ライブラリをロードするためには正確なファイル名がわかっていないとなりません。Linux 環境下では、ヴァージョン番号がわかっている必要があるわけです。
80	82
81	83		ToDo: proposal how the IDE should create version numbers
82	84
83	85		---
84	86		From the Free Pascal wiki, page "Lazarus/FPC Libraries/ja", as it stood on 2021-09-23 after a change by Trev, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).

Back to history