Lazarus Packages/ja: what changed

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

Title: Lazarus Packages/ja

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