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
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
|
---
title: Command Line
slug: Chrome/Command_Line
tags:
- Add-ons
- Extensions
translation_of: Archive/Mozilla/XUL/Providing_Command-Line_Options
---
<div>{{outdated("英語版もあわせてご覧下さい。")}}</div>
<p>拡張機能と XUL アプリケーションは <a href="/ja/docs/NsICommandLineHandler">nsICommandLineHandler</a> を実装したコンポーネントを書いてそれをカテゴリへレジストする事でコマンドラインパラメーターを拾うことができます。</p>
<h2 id="Overview" name="Overview">Overview</h2>
<p>この添付したコードは <a href="/ja/docs/XPCOM">XPCOM</a> フレームワークを用いて書かれたコンポーネントで、<a href="/ja/docs/XPConnect">XPConnect</a> を通して <a href="/ja/docs/JavaScript">JavaScript</a> からアクセスできます。</p>
<p>Firefoxのコマンドラインをハンドル及び初期化についての公式な(簡明な)ページは <a href="/ja/docs/NsICommandLine">nsICommandLine</a> のドキュメントで見つける事ができます。これらは、<a href="/ja/docs/XPIDL">XPIDL</a> ファイルで定義されているインターフェイスの実装されているコードのリンクを見つけられるでしょう。またそれらは <code>.idl</code> ファイルと関係があります。</p>
<p>次に例は二つのコマンドラインパラメータをインプリメントしたコンポーネントの例です。</p>
<dl>
<dt><code>firefox.exe -myapp</code></dt>
<dd>My Applicationの chrome window を開きます。</dd>
<dt><code>firefox.exe -viewapp <var>url</var></code></dt>
<dd>My Applicationの chrome window を開き、nsIURL オブジェクトを通します。</dd>
</dl>
<p>JavaScriptでXPCOMを書くもしくはレジストするこれ以上の方法を見つけるには次の <a href="/ja/docs/How_to_Build_an_XPCOM_Component_in_Javascript"> チュートリアル</a> を試してください。</p>
<p> コンポーネントを順番にレジストする方法は{{Anch("Sample code")}}セクションに詳細があり、大きなボックスにある JavaScript ファイルを<code>.js</code> という拡張子で保存して、Firefox が拡張機能をスキャンするディレクトリ(<a href="/ja/docs/Bundles">Bundles</a>を参照の事)へ入れてください。Windows における典型的な場所は<i>"C:\Program Files\Mozilla Firefox\components"</i> で、もしくはあなたの拡張機能の<code>components</code> ディレクトリになります。</p>
<p>そのとき(Firefoxをシャットダウンしたとき)に、<code>compreg.dat</code> ファイルを削除して Firefox に強制的にコンポーネントのリストを再ビルドさせて、そしてFirefoxを再起動します。<code>compreg.dat</code> ファイルをあなたのプロファイルのディレクトリに見つけても、同じ名前のファイルがFirefox のディレクトリにある事に対して混乱しないでください。</p>
<p>あなたのプロファイルのディレクトリはホームディレクトリ以下 (Linuxであれば、 <i>~/.mozilla/firefox</i> )もしくはたぶん 'Windows上では '"C:\Documents and Settings\(user-name)\Application Data\Mozilla\Firefox\Profiles\"<i> にあるでしょう。</i></p>
<p>Firefoxを再起動した後には、 コンポーネントが新しくなっていれば新たに<code>compreg.dat</code> ファイルが作られるでしょう。</p>
<p>その contact ID はこのようになります: <code>@mozilla.org/commandlinehandler/general-startup;1?type=myapp</code></p>
<p>もし、<a class="external" href="http://ted.mielczarek.org/code/mozilla/extensiondev/">Extension Developer's Extension</a> がインストールされていれば、Javascript shellを通してコンポーネントにアクセスでき、ためしにComponents.classes や Components.classesByID 配列にアクセスできます。これらの例は <a href="/ja/docs/How_to_Build_an_XPCOM_Component_in_Javascript"> このチュートリアル</a>で見ることができます。</p>
<h2 id="Sample_Code" name="Sample_Code">Sample Code</h2>
<pre>const <a href="/ja/docs/NsIAppShellService">nsIAppShellService</a> = Components.interfaces.nsIAppShellService;
const <a href="/ja/docs/NsISupports">nsISupports</a> = Components.interfaces.nsISupports;
const <a href="/ja/docs/NsICategoryManager">nsICategoryManager</a> = Components.interfaces.nsICategoryManager;
const <a href="/ja/docs/NsIComponentRegistrar">nsIComponentRegistrar</a> = Components.interfaces.nsIComponentRegistrar;
const <a href="/ja/docs/NsICommandLine">nsICommandLine</a> = Components.interfaces.nsICommandLine;
const <a href="/ja/docs/NsICommandLineHandler">nsICommandLineHandler</a> = Components.interfaces.nsICommandLineHandler;
const <a href="/ja/docs/NsIFactory">nsIFactory</a> = Components.interfaces.nsIFactory;
const <a href="/ja/docs/NsIModule">nsIModule</a> = Components.interfaces.nsIModule;
const <a href="/ja/docs/NsIWindowWatcher">nsIWindowWatcher</a> = Components.interfaces.nsIWindowWatcher;
// <b>CHANGEME: to the chrome URI of your extension or application</b>
const CHROME_URI = "<a class="external" rel="freelink">chrome://myapp/content/</a>";
// <b>CHANGEME: change the contract id, CID, and category to be unique</b>
// <b>to your application.</b>
const clh_contractID = "@mozilla.org/commandlinehandler/general-startup;1?type=myapp";
// use uuidgen to generate a unique ID
const clh_CID = Components.ID("{2991c315-b871-42cd-b33f-bfee4fcbf682}");
// category names are sorted alphabetically. Typical command-line handlers use a
// category that begins with the letter "m".
const clh_category = "m-myapp";
/**
* Utility functions
*/
/**
* Opens a chrome window.
* @param aChromeURISpec a string specifying the URI of the window to open.
* @param aArgument an argument to pass to the window (may be null)
*/
function openWindow(aChromeURISpec, aArgument)
{
var ww = Components.classes["@mozilla.org/embedcomp/window-watcher;1"].
getService(Components.interfaces.<a href="/ja/docs/NsIWindowWatcher">nsIWindowWatcher</a>);
ww.openWindow(null, aChromeURISpec, "_blank",
"chrome,menubar,toolbar,status,resizable,dialog=no",
aArgument);
}
/**
* The XPCOM component that implements <a href="/ja/docs/NsICommandLineHandler">nsICommandLineHandler</a>.
* It also implements <a href="/ja/docs/NsIFactory">nsIFactory</a> to serve as its own singleton factory.
*/
const myAppHandler = {
/* nsISupports */
QueryInterface : function clh_QI(iid)
{
if (iid.equals(<a href="/ja/docs/NsICommandLineHandler">nsICommandLineHandler</a>) ||
iid.equals(<a href="/ja/docs/NsIFactory">nsIFactory</a>) ||
iid.equals(<a href="/ja/docs/NsISupports">nsISupports</a>))
return this;
throw Components.results.<a href="/ja/docs/NS_ERROR_NO_INTERFACE">NS_ERROR_NO_INTERFACE</a>;
},
/* <a href="/ja/docs/NsICommandLineHandler">nsICommandLineHandler</a> */
handle : function clh_handle(cmdLine)
{
try {
// <b>CHANGEME: change "viewapp" to your command line flag that takes an argument</b>
var uristr = cmdLine.handleFlagWithParam("viewapp", false);
if (uristr) {
// convert uristr to an <a href="/ja/docs/NsIURI">nsIURI</a>
var uri = cmdLine.resolveURI(uristr);
openWindow(CHROME_URI, uri);
cmdLine.preventDefault = true;
}
}
catch (e) {
Components.utils.reportError("incorrect parameter passed to -viewapp on the command line.");
}
// <b>CHANGEME: change "myapp" to your command line flag (no argument)</b>
if (cmdLine.handleFlag("myapp", false)) {
openWindow(CHROME_URI, null);
cmdLine.preventDefault = true;
}
},
<b>// CHANGEME: change the help info as appropriate, but</b>
<b>// follow the guidelines in nsICommandLineHandler.idl</b>
<b>// specifically, flag descriptions should start at</b>
<b>// character 24, and lines should be wrapped at</b>
<b>// 72 characters with embedded newlines,</b>
<b>// and finally, the string should end with a newline</b>
helpInfo : " -myapp Open My Application\n" +
" -viewapp <uri> View and edit the URI in My Application,\n" +
" wrapping this description\n",
/* nsIFactory */
createInstance : function clh_CI(outer, iid)
{
if (outer != null)
throw Components.results.<a href="/ja/docs/NS_ERROR_NO_AGGREGATION">NS_ERROR_NO_AGGREGATION</a>;
return this.QueryInterface(iid);
},
lockFactory : function clh_lock(lock)
{
/* no-op */
}
};
/**
* The XPCOM glue that implements nsIModule
*/
const myAppHandlerModule = {
/* nsISupports */
QueryInterface : function mod_QI(iid)
{
if (iid.equals(<a href="/ja/docs/NsIModule">nsIModule</a>) ||
iid.equals(<a href="/ja/docs/NsISupports">nsISupports</a>))
return this;
throw Components.results.<a href="/ja/docs/NS_ERROR_NO_INTERFACE">NS_ERROR_NO_INTERFACE</a>;
},
/* nsIModule */
getClassObject : function mod_gch(compMgr, cid, iid)
{
if (cid.equals(clh_CID))
return myAppHandler.QueryInterface(iid);
throw Components.results.<a href="/ja/docs/NS_ERROR_NOT_REGISTERED">NS_ERROR_NOT_REGISTERED</a>;
},
registerSelf : function mod_regself(compMgr, fileSpec, location, type)
{
compMgr.QueryInterface(<a href="/ja/docs/NsIComponentRegistrar">nsIComponentRegistrar</a>);
compMgr.registerFactoryLocation(clh_CID,
"myAppHandler",
clh_contractID,
fileSpec,
location,
type);
var catMan = Components.classes["@mozilla.org/categorymanager;1"].
getService(<a href="/ja/docs/NsICategoryManager">nsICategoryManager</a>);
catMan.addCategoryEntry("command-line-handler",
clh_category,
clh_contractID, true, true);
},
unregisterSelf : function mod_unreg(compMgr, location, type)
{
compMgr.QueryInterface(nsIComponentRegistrar);
compMgr.unregisterFactoryLocation(clh_CID, location);
var catMan = Components.classes["@mozilla.org/categorymanager;1"].
getService(nsICategoryManager);
catMan.deleteCategoryEntry("command-line-handler", clh_category);
},
canUnload : function (compMgr)
{
return true;
}
};
/* The NSGetModule function is the magic entry point that XPCOM uses to find what XPCOM objects
* this component provides
*/
function NSGetModule(comMgr, fileSpec)
{
return myAppHandlerModule;
}
</pre>
|
