Lazarus Packages/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のパッケージシステムの概要
2	2
3	3		## lazarusパッケージとは?
4	4
5	5		lazarusパッケージとは、ユニットやコンポーネントを集めたものです。それには、どのようにコンパイルできるかという情報や、IDEや他のパッケージや、プロジェクトで、どうやって使うか、といった情報が含まれています。Delphiと大きく違うところは、パッケージはOSに依存したライブラリではないということです。([[packages\|Library Packagesは]]特別にコンパイルされたライブラリで、アプリケーションやIDEで使われます。Delphiのパッケージは、コンパイラ内部でのサポートを必要としますが、コンパイラマジックを必要としています。fpcは現在の時点ではそのようなコンパイラマジックを受け付けませんし、もちろんそのようなマジックはOS環境に依存するものとなります）
6	6
7	7		現在のところ、[[Free Pascal\|Free Pascalコンパイラは]]、スタティックな（静的にリンクされた）パッケージしかサポートしません。ですから、パッケージをインストールしたり、アンインストールしたりするときには、IDEのコンパイルと再起動が必要です。
8	8
9	9		lazarusパッケージは名前とバージョンによって識別され、区別されます。
10	10
11	11		## よくある質問
12	12
13	13		Q: 私はパッケージをインストールする必要はありますか？
14	14
15	15		A: パッケージが、IDEのコンポーネントパレットのコンポーネントのように、フォーム設計の際に必要な場合に限り、インストールする必要があります。そうでなければ、パッケージをインストールする必要はありません。プロジェクトでパッケージを使いたいだけならば、インストールしないでください。
16	16
17	17		Q: パッケージをインストールしました。しかし、IDEがユニットを見つけてくれません。
18	18
19	19		A: パッケージのインストールとは、パッケージをあなたのプロジェクトではなくIDEに統合することを意味します。この二つは違うものです。あなたのプロジェクトでパッケージを使いたいときは、メニューからProject -\> Project Inspector -\> Add -\> New Requirement　を選択してください。また、IDEに全く機能を付け加えないようなパッケージはアンインストールしてください。
20	20
21	21		## クイックスタート
22	22
23	23		パッケージシステムを使う操作方法です。次のようにしてください。
24	24
25	25		新規のパッケージを作る：
26	26
27	27		- Package-\>New Package or File-\>New... -\> Package -\> Standard Package
28	28		- パッケージエディタが開きます。
29	29		- 左上のSaveボタンを使います。
30	30		- 'enviroment options'の中の'naming'の設定によっては、IDEはファイルを小文字で保存するか尋ねるかもしれません。yesとしてください。
31	31
32	32		これでめでたく最初のパッケージを作ることができました。
33	33
34	34		新しいコンポーネントを追加する：
35	35
36	36		- Addボタンを押す -\> New component
37	37		- 元になる型を示すコンボボックスからコンポーネントを一つ選びます。たとえば、TBevelなど。
38	38		- Okをクリック
39	39		- パッケージにファイルが追加され、エディタ内に表示されます。
40	40		- パッケージエディタの上にある'install'ボタンをクリックすると、パッケージがインストールされます。
41	41		- Lazarusはパッケージを保存し、IDEをリビルドするかどうか尋ねます。Yesを選択してください。
42	42		- パッケージは静的にリンクされるため、IDEの再起動が必要になります。
43	43		- Lazarusが再起動すると、コンポーネントパレットに新しいコンポーネントが表示されます。(この例でいうと、「TBevel1」がAdditionalページに表示されるでしょう。).
44	44		- もし、コンポーネントパレットに新しいコンポーネントが見つからないなら、おそらく、新しくコンパイルしたLazarusを動かしていないからです。Lazarusをどこにリビルドするかの設定は Environment -\> Environment options -\> Files -\> Lazarus directory　でおこなうことができます。
45	45
46	46		Lazarusがインストールされたディレクトリに対する書き込み権限がない場合には、Lazarusを直接呼び出す代わりに、startlazarusコマンドも使えます。これはたとえば、 ~/.lazarusにある新しく生成されたLazarsuの実行ファイルを起動します。
47	47
48	48		これでめでたく最初のコンポーネントを入れた最初のパッケージをインストールできました。
49	49
50	50		## パッケージのためのIDEメニュー
51	51
52	52		- File-\>New... -\> Package -\> Standard Package
53	53
54	54		新しいパッケージを作ります。
55	55
56	56		- Project -\> Project Inspector
57	57
58	58		` ここで、現在開いているプロジェクトで必要とされているパッケージを見ることができます。`\
59	59		` 新しくパッケージへの依存関係を追加することや、不要になったパッケージへの依存を削除することができます。`
60	60
61	61		- Run -\> Compiler options -\> Inherited
62	62
63	63		` ここでコンパイラオプションをどのパッケージから継承するかを見ることができます。`
64	64
65	65		Components -\>
66	66
67	67		` - 'Open package'`\
68	68		` すべてのパッケージを開くことができるダイアログを表示します。`\
69	69		` `\
70	70		` - 'Open package file'`\
71	71		` .lpk ファイルを開きます。`\
72	72		` `\
73	73		` - 'Open package of current unit'`\
74	74		` 現在ソースエディタで開いているファイルに属している.lpk ファイルを開きます。`\
75	75		` `\
76	76		` - 'Open recent package'`\
77	77		` 最近開いたパッケージファイル(lpk file)を開きます。`\
78	78		` `\
79	79		` - 'Add active unit to a package'`\
80	80		` ソースエディタで開いているユニットをパッケージに追加します。`\
81	81		` `\
82	82		` - 'Package Graph'`\
83	83		` 開いているすべてのパッケージの一覧と相関図を表示します。`\
84	84		` `\
85	85		` - 'Configure installed packages'`\
86	86		` IDEにインストールされているパッケージの一覧を編集します。一度に個々のインストール、アンインストールがおこなえます。`
87	87
88	88		Project -\> Project Inspector
89	89
90	90		` ここでは、プロジェクトで使われているすべてのパッケージを確認したり変更することができます。`
91	91
92	92		## 理屈
93	93
94	94		各々のLazarusパッケージに.lpkファイルが一つずつあります。パッケージは名前とバージョンで識別されます。名前はlpkファイル名と同じでなくてはなりません。たとえば、次のように： Name: Package1, Version: 1.0, Filename: /home/.../package1.lpk.
95	95
96	96		- IDEは自動的にメインのソースファイルを生成します。(package1.pas) 下を見てください。lpkファイルは必要とするパッケージの情報（どのファイルが必要か、どのようにコンパイルするか、他のプロジェクトやパッケージで利用される際に、何が必要となるか、など）をもっています。lpkファイルがあるディレクトリは "package directory"と呼ばれます。
97	97		- IDEは全てのパッケージファイルのリストをもっています。(\<config directory\>/packagelinks.xml). IDEでパッケージを開くたびに、それがこのリストに追加されます。パッケージが開かれる度に、IDEは必要となる全てのパッケージを自動的に開きますが、それにはこのリストを使います。
98	98		- 3つの基本となるパッケージがあります。FCL, LCL と SynEditです。これらはIDEの一部であるため、これらのパッケージは自動的に作られ、読み取り専用であり、lpkファイルもありません。
99	99		- 通常、パッケージには1つのソースディレクトリがあり、そのディレクトリにはいくつかのPascalユニットがはいっています。通常、lpkファイルもそのディレクトリにあります。パッケージは、また1つの出力ディレクトリを持っています。デフォルトは、パッケージディレクトリ内の 'lib/\$(TargetCPU)-\$(TargetOS)/' です。
100	100		- パッケージをコンパイルする前に、IDEは全部の依存するパッケージをチェックして、依存するパッケージが更新する必要があるかどうか、自動更新フラグがセットされているか調べて、もしそうなら、それらを先にコンパイルします。次いでIDEはパッケージのメインソースファイルを生成します。もし、lpkファイルの名前がpackage1.lpkであれば、メインソースファイルは package1.pasです。このファイルは、usesセクションにすべての使用するユニットを含み、また、Register手続きを含んでいます。この手続きはinitialization節で呼ばれます。
101	101
102	102		例:
103	103
104	104		`This file was automatically created by Lazarus. Do not edit!`\
105	105		`This source is only used to compile and install`\
106	106		`the package GTKOpenGL 1.0.`\
107	107		` unit GTKOpenGL;`\
108	108		`interface`\
109	109		`uses GTKGLArea, GTKGLArea_Int, NVGL, NVGLX, LazarusPackageIntf;`\
110	110		`implementation`\
111	111		`procedure Register;`\
112	112		`begin`\
113	113		` RegisterUnit('GTKGLArea', @GTKGLArea.Register);`\
114	114		`end;`\
115	115		`initialization`\
116	116		` RegisterPackage('GTKOpenGL', @Register)`\
117	117		`end.`
118	118
119	119		- その後、コンパイラが実行されて、パッケージが出力ディレクトリに生成されます。
120	120		- コンパイルが成功すると、ステートファイルが生成されます。ステートファイルは出力ディレクトリに置かれます。\<packagename\>.compiledという名前で、どのようにコンパイルされたか、という情報をもっています。IDEはこの状態ファイルを用いてパッケージの更新が必要かどうかチェックします。
121	121
122	122		gtkopengl.compiled　の例:
123	123
124	124		`<?xml version="1.0"?>`\
125	125		`<CONFIG>`\
126	126		` <Compiler Value="/usr/bin/ppc386" Date="781388725"/>`\
127	127		` <Params Value=" -Rintel -S2cgi -CD -Ch8000000 -OG1p1`\
128	128		` -Tlinux -gl -vewnhi -l -Fu../../../lcl/units`\
129	129		` -Fu../../../lcl/units/gtk -Fu../../../packager/units`\
130	130		` -Fu. -FElib/ gtkopengl.pas"/>`\
131	131		`</CONFIG>`
132	132
133	133		- IDEは必要とする全てのパッケージを自動的に開きます。ここでいう全てのパッケージとは、インストールされているすべてのパッケージ、インストール設定で、自動インストールとマークされたすべてのパッケージ、開いているエディタ上のすべてのパッケージ、プロジェクトや他のパッケージで必要としているパッケージ、です。必要としないパッケージは、IDEがアイドル状態になると、自動的にアンロードされます。
134	134		- IDEは同時に同じ名前のパッケージを二つ開くことはしません。ユーザーがすでにインストールされているパッケージと同じ名前の他のパッケージファイルを開こうとすると、IDEは古いパッケージと置き換えるかどうか尋ねます。
135	135		- 他にもIDEは二種類のパッケージを記録しています。インストールされたパッケージと、自動インストールパッケージです。自動インストールパッケージは、次にコンパイルされる時にIDEにリンクされます。これは2つの新しいファイルをconfigフォルダに生成します。staticpackages.inc と、 idemake.cfg　です。次いで'make ide OPT=@/path/to/your/config/idemake.cfg' とすることで、IDEは自分自身をコンパイルします。
136	136
137	137		## ヒントと例題
138	138
139	139		ここにヒントや例題などを書いてください。
140	140
141	141		- パッケージの名前を変更するには、'save as'を使ってください。
142	142
143	143		Example
144	144
145	145		`I will use the tiOPF framework as an example The tiOPF has the`\
146	146		`following directory layout, due to the fact that it compiles for FPC,`\
147	147		`Delphi 5-7, D2005 and D2006.`\
148		-	\
	148	+
149	149		`Source <= full path \Programming\3rdParty\tiOPF\Source`\
150	150		` \Compilers`\
151	151		` \Delphi7 <= Delphi 7 package files live here`\
152	152		` \D2005`\
153	153		` \FPC <= the tiOPF.lpk lived here`\
154	154		` \Core <= core unit files`\
155	155		` \Options <= optional unit file for extra features`\
156	156		` \GUI`\
157		-	\
	157	+
158	158		`Using this example, I included in the "Options - Usage - Units"`\
159	159		`editbox the following paths:`\
160	160		`"$(PkgOutDir);..\..\Core;..\..\Options;..\..\GUI" which will be added`\
161	161		`to whatever project uses this package.`
162	162
163	163		## コンポーネントを既存のパッケージに追加するには
164	164
165	165		コンポーネントを含んだファイルを既存のパッケージに追加するには、次のようにすればできます:
166	166
167	167		- パッケージファイルを開きます。
168	168		- 新しい要素をパッケージに追加するため'Add' をクリックします。
169	169		- 'Add to package' ダイアログから unit タブを選びます。
170	170		- 追加するファイルを選びます。
171	171		- ユニットに Register 手続きがあるなら、'Has register procedure' をチェックします。これをチェックしないと、コンポーネントはコンポーネントパレットに追加されません。
172	172		- 'Add unit' をクリックします。
173	173		- リコンパイルして、パッケージをインストールします。
174	174
175	175		これだけで、コンポーネントがコンポーネントパレットに現れることになります。
176	176
177	177		## Register 手続き
178	178
179	179		コンポーネントは Lazarus に登録されてはじめてコンポーネントパレットに現れます。この登録を行うのが Register 手続きです。この手続きはインストールプロパティやコンポーネント用のコンポーネントエディタと同じく、ユニットの interface 節に現れる必要があり、その手続きの中で RegisterComponent を実行する必要があります。
180	180
181	181		一つのパッケージの中に、複数の Register 手続きがあってもかまいませんが、パッケージエディタで、登録用手続きをもつユニットがどれか指定する必要があります。そうすれば、Lazarusはパッケージをインストールする時どの手続きを呼ばなければならないかわかります。
182	182
183	183		登録手続きをもつユニットをマークするには、二つの方法があります:
184	184
185	185		上記のように、ユニットをパッケージに追加する操作の間に行うことができます。また、パッケージダイアログの中でユニットを選び、details パネルの中の 'Register' チェックボックスをチェックすることもできます。プロパティを変更した後、リコンパイルしてインストールするのを忘れないで下さい。
186	186
187	187		## 貢献している人とコメント
188	188
189	189		This page has been converted from the epikwiki [version](http://lazarus-ccr.sourceforge.net/index.php?wiki=LazarusPackages).
190	190
191	191		---
192	192		From the Free Pascal wiki, page "Lazarus Packages/ja", as it stood on 2008-08-07 after a change by TheCreativeCAT, 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