aboutsummaryrefslogtreecommitdiff
path: root/files/ja/archive/mozilla/xulrunner/getting_started_with_xulrunner/index.html
blob: 0ce275540d80511cdb1075b452a2a217fa1a8851 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
---
title: Getting started with XULRunner
slug: Archive/Mozilla/XULRunner/Getting_started_with_XULRunner
tags:
  - XUL
  - XULRunner
translation_of: Archive/Mozilla/XULRunner/Getting_started_with_XULRunner
---
<div><div class="prevnext" style="text-align: right;">
    <p><a href="/ja/docs/Windows_and_menus_in_XULRunner">次のページ  »</a></p>
</div></div>

<p>この記事は、<a href="/ja/docs/XULRunner">XULRunner</a> を使った 基本的なデスクトップアプリケーションを作成することで、Mozilla プラットフォームを体験します。Firefox、Thunderbird、他の複数のアプリケーションがこのプラットフォームを使って実装されていることを考えれば、基本的なアプリケーションを作成するためにこのプラットフォームを使うのは、安全な選択です。</p>
<p>XUL ベースのデスクトップアプリケーションを作成したいならば、恐らく、XULRunner をインストールする必要があるでしょう。XULRunner をインストールすることから始めましょう。それから、ベアボーンアプリケーションが実行されることを確認します。</p>
<p><span id="Step_1:_Download_XULRunner"></span></p>
<h2 id="Step_1:_XULRunner_.E3.81.AE.E3.83.80.E3.82.A6.E3.83.B3.E3.83.AD.E3.83.BC.E3.83.89" name="Step_1:_XULRunner_.E3.81.AE.E3.83.80.E3.82.A6.E3.83.B3.E3.83.AD.E3.83.BC.E3.83.89">Step 1: XULRunner のダウンロード</h2>
<p>MDC の <a href="/ja/docs/XULRunner">XULRunner</a> のメインページでダウンロードリンクを見つけることができます。</p>
<p>Windows 用の XULRunner のダウンロードは zip ファイルで、本当のインストールではありません。開発者の一人として、私は XULRunner はマシンに解凍するだけで十分だと考ています。Windows システムへフックする必要はないと思います。</p>
<p>XULRunner の Mac バージョンは、標準的な Mac OS X インストーラ形式で配布されています。</p>
<p><span id="Step_2:_Install_XULRunner"></span></p>
<h2 id="Step_2:_XULRunner_.E3.81.AE.E3.82.A4.E3.83.B3.E3.82.B9.E3.83.88.E3.83.BC.E3.83.AB" name="Step_2:_XULRunner_.E3.81.AE.E3.82.A4.E3.83.B3.E3.82.B9.E3.83.88.E3.83.BC.E3.83.AB">Step 2: XULRunner のインストール</h2>
<p>Windows では、zip アーカイブを手頃な場所に解凍してください。私は新規フォルダ &lt;tt&gt;C:\program files\xulrunner&lt;/tt&gt; に解凍しました。簡単です。Mac では、単にインストーラを実行するだけです。&lt;tt&gt;/Library/Frameworks&lt;/tt&gt; ディレクトリ内に &lt;tt&gt;XUL.Framework&lt;/tt&gt; として XULRunner がインストールされます。</p>
<p>最初に、簡単なベアボーンアプリケーションシェルから始めます。これを XUL "Hello World" と呼んでもよいでしょう。Google は、<a class="external" href="http://blogs.acceleration.net/ryan/archive/2005/05/06/1073.aspx">Ryan による素晴らしいチュートリアル</a><span style="color: darkgreen; background: #ef9;">【訳注: 英語】</span> を探してきました。これは間違いなく読む価値があります。そのチュートリアルを使って、私は簡単なブートストラップアプリケーションを作りました。あなたが以下で読むことの全ては、Ryan のチュートリアルと MDC の <a href="/ja/docs/XULRunner">XULRunner</a> 関連文書にあります。</p>
<p><span id="Step_3:_Create_the_application_folder_struture"></span></p>
<h2 id="Step_3:_.E3.82.A2.E3.83.97.E3.83.AA.E3.82.B1.E3.83.BC.E3.82.B7.E3.83.A7.E3.83.B3.E3.83.95.E3.82.A9.E3.83.AB.E3.83.80.E6.A7.8B.E9.80.A0.E3.82.92.E4.BD.9C.E6.88.90.E3.81.99.E3.82.8B" name="Step_3:_.E3.82.A2.E3.83.97.E3.83.AA.E3.82.B1.E3.83.BC.E3.82.B7.E3.83.A7.E3.83.B3.E3.83.95.E3.82.A9.E3.83.AB.E3.83.80.E6.A7.8B.E9.80.A0.E3.82.92.E4.BD.9C.E6.88.90.E3.81.99.E3.82.8B">Step 3: アプリケーションフォルダ構造を作成する</h2>
<p>Windows 上で、私は新規フォルダ &lt;tt&gt;c:\program files\myapp&lt;/tt&gt; をルートとして作成しましたが、あなたの好きな場所に作成してかまいません。サブフォルダの構造は以下です。:</p>
<pre>/myapp
  /chrome
    /content
      main.xul
    chrome.manifest
  /defaults
    /preferences
      prefs.js
  application.ini
</pre>
<p>フォルダ構造内に 4 つのファイルがあることに注意してください。: &lt;tt&gt;application.ini&lt;/tt&gt;&lt;tt&gt;chrome.manifest&lt;/tt&gt;&lt;tt&gt;prefs.js&lt;/tt&gt;、そして、&lt;tt&gt;main.xul&lt;/tt&gt;</p>
<p><span id="Step_4:_&lt;tt>Set_up_application.ini&lt;/tt>"></span></p>
<h2 id="Step_4:_application.ini_.E3.81.AE.E3.82.BB.E3.83.83.E3.83.88.E3.82.A2.E3.83.83.E3.83.97" name="Step_4:_application.ini_.E3.81.AE.E3.82.BB.E3.83.83.E3.83.88.E3.82.A2.E3.83.83.E3.83.97">Step 4: &lt;tt&gt;application.ini のセットアップ&lt;/tt&gt;</h2>
<p>&lt;tt&gt;<a href="/ja/docs/XUL_Application_Packaging">application.ini</a>&lt;/tt&gt; ファイルは、あなたのアプリケーションを動作させるための XULRunner エントリーポイントとしての働きを持ちます。あなたのアプリケーションがどのように XULRunner プラットフォームを使うことを意図しているか、そして、XULRunner があなたのアプリケーションを実行するために用いるいくつかの情報の構成を指定します。:</p>
<pre>[App]
Vendor=Finkle
Name=Test App
Version=1.0
BuildID=20060101
Copyright=Copyright (c) 2006 Mark Finkle
ID=xulapp@starkravingfinkle.org

[Gecko]
MinVersion=1.8
MaxVersion=1.9.0.*
</pre>
<p><span class="comment">本当ではありません... &lt;tt&gt;application.ini&lt;/tt&gt; ファイルについてのさらなる情報は、[XULRunner:Deploying XULRunner 1.8]] の記事で見つけることができます。</span></p>
<p><i>注意:</i> この 2006 年のサンプルを 2007 年のナイトリー trunk の XULRunner ビルドで動かすには、MaxVersion を 1.9 に変更してください。</p>
<p><span id="Step_5:_Set_up_the_chrome_manifest"></span></p>
<h2 id="Step_5:_chrome_.E3.83.9E.E3.83.8B.E3.83.95.E3.82.A7.E3.82.B9.E3.83.88_.E3.81.AE.E3.82.BB.E3.83.83.E3.83.88.E3.82.A2.E3.83.83.E3.83.97" name="Step_5:_chrome_.E3.83.9E.E3.83.8B.E3.83.95.E3.82.A7.E3.82.B9.E3.83.88_.E3.81.AE.E3.82.BB.E3.83.83.E3.83.88.E3.82.A2.E3.83.83.E3.83.97">Step 5: chrome マニフェスト のセットアップ</h2>
<p><a href="/ja/docs/Chrome_Registration">chrome マニフェスト</a>ファイルは、XULRunner がアプリケーションリソースを配置するために使われる特定の URI を定義するために使われます。これは、“<a class="external" rel="freelink">chrome://</a>” URI がどのように使われるかを理解することで、より明確になるでしょう。アプリケーション chrome は、単一あるいはわずかな複数の JAR ファイル、もしくは、 圧縮されていないフォルダとファイル内にあります。私は今は圧縮されていない方法を使っています。以下が、私のマニフェストです。:</p>
<pre class="eval"> content myapp file:content/
</pre>
<div class="note">
  注意: アプリケーション名は小文字で、3 文字より長くなければなりません。</div>
<p><span id="Step_6:_Set_up_preferences"></span></p>
<h2 id="Step_6:_.E8.A8.AD.E5.AE.9A.E3.81.AE.E3.82.BB.E3.83.83.E3.83.88.E3.82.A2.E3.83.83.E3.83.97" name="Step_6:_.E8.A8.AD.E5.AE.9A.E3.81.AE.E3.82.BB.E3.83.83.E3.83.88.E3.82.A2.E3.83.83.E3.83.97">Step 6: 設定のセットアップ</h2>
<p>&lt;tt&gt;prefs.js&lt;/tt&gt; ファイルは、XULRunner にメインウィンドウとして使われる XUL ファイルの名前を伝えます。以下が私のファイルです。:</p>
<pre class="eval"> pref("toolkit.defaultChromeURI", "<a class="external" rel="freelink">chrome://myapp/content/main.xul</a>");
</pre>
<p>XULRunner の設定は以下を含みます。:</p>
<dl>
  <dt>
    <code><a href="/ja/docs/Toolkit.defaultChromeURI">toolkit.defaultChromeURI</a></code></dt>
  <dd>
    アプリケーションが実行されるときに開くデフォルトのウィンドウを指定します。</dd>
  <dt>
    <code><a href="/ja/docs/Toolkit.defaultChromeFeatures">toolkit.defaultChromeFeatures</a></code></dt>
  <dd>
    <code><a href="/ja/docs/Window.open">window.open()</a></code> が渡されると、メインアプリケーションウィンドウが開かれますが、そのときのウィンドウの特性を指定します。</dd>
  <dt>
    <code><a href="/ja/docs/Toolkit.singletonWindowType">toolkit.singletonWindowType</a></code></dt>
  <dd>
    一度に一つのインスタンスだけしか許可しないように、アプリケーションの構成を設定します。</dd>
</dl>
<p>これらは、<a href="/ja/docs/XULRunner/Specifying_Startup_Chrome_Window">XULRunner:Specifying Startup Chrome Window</a> でさらに詳しく説明されています。</p>
<p><span id="Step_7:_Create_some_XUL"></span></p>
<h2 id="Step_7:_XUL_.E3.81.AE.E4.BD.9C.E6.88.90" name="Step_7:_XUL_.E3.81.AE.E4.BD.9C.E6.88.90">Step 7: XUL の作成</h2>
<p>最後に、単純な XUL ウィンドウを作成しなければなりません。それは、&lt;tt&gt;main.xul&lt;/tt&gt; ファイル内に記述されます。以下は、装飾の全くない、まさに最小の内容です。メニューも何もありません。:</p>
<pre>&lt;?xml version="1.0"?&gt;
&lt;?xml-stylesheet href="chrome://global/skin/" type="text/css"?&gt;

&lt;window id="main" title="My App" width="300" height="300"
xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"&gt;
  &lt;caption label="Hello World"/&gt;
&lt;/window&gt;
</pre>
<div class="note">
  注意: XML/XUL ファイルの最初に余計な空白があってはいけません。</div>
<p><span id="Step_8:_Run_the_application"></span></p>
<h2 id="Step_8:_.E3.82.A2.E3.83.97.E3.83.AA.E3.82.B1.E3.83.BC.E3.82.B7.E3.83.A7.E3.83.B3.E3.81.AE.E5.AE.9F.E8.A1.8C" name="Step_8:_.E3.82.A2.E3.83.97.E3.83.AA.E3.82.B1.E3.83.BC.E3.82.B7.E3.83.A7.E3.83.B3.E3.81.AE.E5.AE.9F.E8.A1.8C">Step 8: アプリケーションの実行</h2>
<p>ついにこのときが来ました。ベアボーンアプリケーションを実行するためには、XULRunner を手に入れる必要があります。Windows コマンドプロンプトから、&lt;tt&gt;C:\program files\myapp&lt;/tt&gt; フォルダを開き、以下を実行してください。:</p>
<pre class="eval"> xulrunner.exe application.ini
</pre>
<p>もちろん、xulrunner.exe が、<code>PATH</code> に含まれていなければなりません。含まれていない場合、私が XULRunner を解凍した場所と同じならば、以下を実行することもできます。:</p>
<pre class="eval"> ..\xulrunner\xulrunner.exe application.ini
</pre>
<p>Mac では、 Terminal ウィンドウを開き、&lt;tt&gt;myapp&lt;/tt&gt; ディレクトリに移動し、以下を入力することによって、アプリケーションを実行できます。:</p>
<pre class="eval"> /Library/Frameworks/XUL.framework/xulrunner-bin application.ini
</pre>
<p>今、あなたはこのように見えるウィンドウを見るはずです。このスクリーンショットは、Windows 2000 の場合です。</p>
<p><img alt="Image:XULSampleMyapp.png"></p>
<p><span id="Alternative:_Use_Firefox3_-app_to_run_XUL_apps"></span></p>
<h3 id=".E5.88.A5.E3.81.AE.E6.96.B9.E6.B3.95:_XUL_.E3.82.A2.E3.83.97.E3.83.AA.E3.82.92.E5.AE.9F.E8.A1.8C.E3.81.99.E3.82.8B.E3.81.9F.E3.82.81.E3.81.AB_Firefox3_.E3.81.AE_-app_.E3.82.AA.E3.83.97.E3.82.B7.E3.83.A7.E3.83.B3.E3.82.92.E4.BD.BF.E3.81.86" name=".E5.88.A5.E3.81.AE.E6.96.B9.E6.B3.95:_XUL_.E3.82.A2.E3.83.97.E3.83.AA.E3.82.92.E5.AE.9F.E8.A1.8C.E3.81.99.E3.82.8B.E3.81.9F.E3.82.81.E3.81.AB_Firefox3_.E3.81.AE_-app_.E3.82.AA.E3.83.97.E3.82.B7.E3.83.A7.E3.83.B3.E3.82.92.E4.BD.BF.E3.81.86">別の方法: XUL アプリを実行するために Firefox3 の -app オプションを使う</h3>
<p>Firefox 3 では、 コマンドラインから Firefox に 通常起動時の Firefox ブラウザの代わりに XUL アプリケーションを実行させるように指示することができます。<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=388833" title="FIXED: Add a way to launch XUL applications from Firefox commandline">バグ 388833</a> を参照してください。</p>
<p><a class="external" href="http://developer.mozilla.org/samples/xulrunner/myapp.zip">サンプルプロジェクト</a>をダウンロードできます。</p>
<p></p><div class="prevnext" style="text-align: right;">
    <p><a href="/ja/docs/Windows_and_menus_in_XULRunner">次のページ  »</a></p>
</div><p></p>
<div class="originaldocinfo">
  <p><span id="Original_Document_Information"></span></p>
  <h2 id="Original_Document_Information" name="Original_Document_Information">Original Document Information</h2>
  <ul>
    <li>Author: Mark Finkle</li>
    <li>Last Updated Date: October 2, 2006</li>
  </ul>
</div>