2000-05-14 18:22:11 +00:00
|
|
|
<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
|
|
|
|
|
<html>
|
|
|
|
|
<head>
|
|
|
|
|
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
|
|
|
|
|
<meta name="Author" content="Suresh Duddi">
|
|
|
|
|
<meta name="GENERATOR" content="Mozilla/4.71 [en] (X11; U; Linux 2.2.12-20 i686) [Netscape]">
|
|
|
|
|
</head>
|
|
|
|
|
<body>
|
|
|
|
|
|
|
|
|
|
<center>
|
|
|
|
|
<h2>
|
|
|
|
|
Standalone XPCOM v 0.5</h2></center>
|
|
|
|
|
|
|
|
|
|
<center>Version 0.5
|
|
|
|
|
<br>15 May 2000
|
|
|
|
|
<br>Suresh Duddi <dp@netscape.com>
|
|
|
|
|
<hr WIDTH="100%"></center>
|
|
|
|
|
|
|
|
|
|
<h3>
|
2000-05-16 23:18:31 +00:00
|
|
|
1.0 Overview</h3>
|
2000-05-14 18:22:11 +00:00
|
|
|
Standalone XPCOM is a tree configuration, that when built, provides a minimal
|
|
|
|
|
set of libraries (shared mostly) that can be used to get all features of
|
|
|
|
|
XPCOM. The contents of this standalone XPCOM in general are:
|
|
|
|
|
<ul>
|
|
|
|
|
<li>
|
2000-05-15 07:21:12 +00:00
|
|
|
NSPR : mozilla/nsprpub</li>
|
2000-05-14 18:22:11 +00:00
|
|
|
|
|
|
|
|
<li>
|
2000-05-15 07:21:12 +00:00
|
|
|
Registry : mozilla/modules/libreg</li>
|
2000-05-14 18:22:11 +00:00
|
|
|
|
|
|
|
|
<li>
|
2000-05-15 07:21:12 +00:00
|
|
|
XPCOM : mozilla/xpcom</li>
|
2000-05-14 18:22:11 +00:00
|
|
|
</ul>
|
2000-05-26 01:22:01 +00:00
|
|
|
<b>NOTE 1: xpcom apis are not frozen yet. By XPCOM 1.0 release they will
|
2000-05-16 23:18:31 +00:00
|
|
|
be.</b>
|
2000-05-26 01:22:01 +00:00
|
|
|
<br><b>NOTE 2: xpcom standalone differs from the xpcom built with mozilla.
|
|
|
|
|
Hence cannot be used with the mozilla browser.</b>
|
2000-05-14 18:22:11 +00:00
|
|
|
<h3>
|
|
|
|
|
2.0 Building Standalone XPCOM</h3>
|
|
|
|
|
Here are the instructions for building the Standalone XPCOM on unix:
|
2000-05-15 07:21:12 +00:00
|
|
|
<br>
|
|
|
|
|
<ol><b>Step 1 : Pull the sources</b>
|
|
|
|
|
<li>
|
2000-05-16 23:18:31 +00:00
|
|
|
<tt>cvs -z 3 co mozilla/client.mk</tt></li>
|
2000-05-14 18:22:11 +00:00
|
|
|
|
|
|
|
|
<li>
|
2000-05-16 23:18:31 +00:00
|
|
|
<tt>cd mozilla</tt></li>
|
2000-05-15 07:21:12 +00:00
|
|
|
|
|
|
|
|
<li>
|
2000-05-16 23:18:31 +00:00
|
|
|
<tt>gmake -f client.mk pull_all BUILD_MODULES=xpcom</tt></li>
|
2000-05-14 18:22:11 +00:00
|
|
|
</ol>
|
|
|
|
|
|
2000-05-16 23:18:31 +00:00
|
|
|
<ol><b>Step 2 : Build XPCOM Standalone (unix)</b>
|
2000-05-15 07:21:12 +00:00
|
|
|
<li>
|
2000-05-17 07:54:22 +00:00
|
|
|
<tt>configure --enable-modules=xpcom</tt></li>
|
2000-05-15 07:21:12 +00:00
|
|
|
|
2000-05-14 18:22:11 +00:00
|
|
|
<li>
|
2000-05-16 23:18:31 +00:00
|
|
|
<tt>gmake</tt></li>
|
2000-05-14 18:22:11 +00:00
|
|
|
</ol>
|
2000-05-26 01:22:01 +00:00
|
|
|
<i>Thanks to Christopher Seawood <cls@seawood.org> for make this so
|
|
|
|
|
simple.</i>
|
2000-05-14 18:22:11 +00:00
|
|
|
<h3>
|
|
|
|
|
3.0 Testing Standalone XPCOM</h3>
|
|
|
|
|
<tt>xpcom/sample</tt> contains a sample application and a component. This
|
|
|
|
|
should get built by default.
|
|
|
|
|
<ul>
|
|
|
|
|
<li>
|
|
|
|
|
<tt>nsTestSample</tt> is the sample application. This should have been
|
|
|
|
|
installed in your <tt>bin/</tt> directory.</li>
|
|
|
|
|
|
|
|
|
|
<li>
|
|
|
|
|
<tt>libsample.so (unix) </tt>is the sample component implementation that
|
|
|
|
|
the sample application will try to instantiate. This should have been installed
|
|
|
|
|
in your <tt>bin/components</tt> directory</li>
|
|
|
|
|
</ul>
|
|
|
|
|
To run the test,
|
|
|
|
|
<ol>
|
|
|
|
|
<li>
|
|
|
|
|
cd to your <tt>bin/</tt> directory</li>
|
|
|
|
|
|
|
|
|
|
<li>
|
|
|
|
|
setenv LD_LIBRARY_PATH .</li>
|
|
|
|
|
|
|
|
|
|
<li>
|
2000-05-15 07:21:12 +00:00
|
|
|
<tt>./nsTestSample</tt></li>
|
2000-05-14 18:22:11 +00:00
|
|
|
|
2000-05-15 07:21:12 +00:00
|
|
|
<br><tt>Warning: MOZILLA_FIVE_HOME not set.</tt>
|
2000-05-14 18:22:11 +00:00
|
|
|
<br><tt>nsNativeComponentLoader: autoregistering begins.</tt>
|
|
|
|
|
<br><tt>nsNativeComponentLoader: autoregistering succeeded</tt>
|
2000-05-15 07:21:12 +00:00
|
|
|
<br><tt>Inital print: initial value</tt>
|
|
|
|
|
<br><tt>Set value to: XPCOM defies gravity</tt>
|
|
|
|
|
<br><tt>Final print : XPCOM defies gravity</tt>
|
2000-05-14 18:22:11 +00:00
|
|
|
<br><b><tt>Test passed.</tt></b></ol>
|
|
|
|
|
|
|
|
|
|
<h3>
|
2000-05-15 07:21:12 +00:00
|
|
|
4.0 Test FAILED: What went wrong ?</h3>
|
2000-05-14 18:22:11 +00:00
|
|
|
The most common case of why the sample would have failed if you didn't
|
2000-05-15 07:21:12 +00:00
|
|
|
run it from the bin directory. Here are some error messsages and possible
|
2000-05-14 18:22:11 +00:00
|
|
|
ways of fixing them.
|
|
|
|
|
<ol>
|
|
|
|
|
<li>
|
|
|
|
|
<b><tt>./nsTestSample: error in loading shared libraries: libxpcom.so:
|
|
|
|
|
cannot open shared object file: No such file or directory</tt></b></li>
|
|
|
|
|
|
2000-05-15 07:21:12 +00:00
|
|
|
<ol>LD_LIBRARY_PATH not set. To fix "<tt>setenv LD_LIBRARY_PATH ."</tt></ol>
|
2000-05-14 18:22:11 +00:00
|
|
|
|
|
|
|
|
<li>
|
|
|
|
|
<b>Link errors when building xpcom standalone</b></li>
|
|
|
|
|
|
|
|
|
|
<ol>This is mostly due to the fact that probably xpcom is not being built
|
2000-05-26 01:22:01 +00:00
|
|
|
standalone. Make sure you did "<tt>configure --enable-modules=xpcom"</tt></ol>
|
2000-05-14 18:22:11 +00:00
|
|
|
</ol>
|
|
|
|
|
|
|
|
|
|
<h3>
|
|
|
|
|
5.0 Whats the difference between Standalone and non-Standalone XPCOM</h3>
|
|
|
|
|
Here is what we had to do to get a working standalone XPCOM
|
|
|
|
|
<ol>
|
|
|
|
|
<li>
|
|
|
|
|
Disabled all forms of unicode conversion. nsString, nsCRT were using this
|
2000-05-15 07:21:12 +00:00
|
|
|
in various forms. Only ASCII is expected to work. Other charsets including
|
2000-05-14 18:22:11 +00:00
|
|
|
unicode are not guaranteed to work.</li>
|
|
|
|
|
|
|
|
|
|
<li>
|
2000-05-15 07:21:12 +00:00
|
|
|
Disabled nsUnicharInputStream. This causes nsPersistentProperties to always
|
|
|
|
|
fail.</li>
|
2000-05-14 18:22:11 +00:00
|
|
|
|
|
|
|
|
<li>
|
|
|
|
|
Disabled control of XPT from preferences.</li>
|
|
|
|
|
|
|
|
|
|
<li>
|
2000-05-15 07:21:12 +00:00
|
|
|
Disabled use of ZIP format of XPT files.</li>
|
2000-05-14 18:22:11 +00:00
|
|
|
</ol>
|
2000-05-26 01:22:01 +00:00
|
|
|
Until we fix these differences, the non-standalone xpcom will be the one
|
|
|
|
|
used by the mozilla browser.
|
2000-05-14 18:22:11 +00:00
|
|
|
<h3>
|
2000-05-15 07:21:12 +00:00
|
|
|
6.0 TODO for v 1.0</h3>
|
2000-05-14 18:22:11 +00:00
|
|
|
|
|
|
|
|
<ol>
|
|
|
|
|
<li>
|
2000-05-15 07:21:12 +00:00
|
|
|
Enable XPCOM to work with unicode. Unicode, ASCII and ISO8859-1 will be
|
|
|
|
|
the charset that will be self supported by XPCOM.</li>
|
2000-05-14 18:22:11 +00:00
|
|
|
|
|
|
|
|
<li>
|
|
|
|
|
Optional exclusion of specific features into standalone XPCOM like unicode
|
|
|
|
|
support, registry, xpconnect. Tweeking these options will cause reduction
|
|
|
|
|
in memory requirements and size.</li>
|
|
|
|
|
|
|
|
|
|
<li>
|
|
|
|
|
Get <tt>xpcom/tests</tt> directory upto date and documented.</li>
|
|
|
|
|
|
|
|
|
|
<li>
|
2000-05-15 07:21:12 +00:00
|
|
|
Make standalone XPCOM the only deliverable from xpcom. No more <tt>#ifndef
|
2000-05-14 18:22:11 +00:00
|
|
|
XPCOM_STANDALONE</tt></li>
|
|
|
|
|
|
|
|
|
|
<li>
|
|
|
|
|
Update this document for both Windows and Mac.</li>
|
|
|
|
|
|
|
|
|
|
<li>
|
2000-05-15 07:21:12 +00:00
|
|
|
API freeze and documentation</li>
|
2000-05-14 18:22:11 +00:00
|
|
|
</ol>
|
|
|
|
|
|
|
|
|
|
<h3>
|
|
|
|
|
7.0 Future (post v 1.0)</h3>
|
2000-05-15 07:21:12 +00:00
|
|
|
mmh! let me think...
|
2000-05-14 18:22:11 +00:00
|
|
|
<p>
|
|
|
|
|
<hr WIDTH="100%">
|
|
|
|
|
<br>Suresh Duddi <dp@netscape.com>
|
|
|
|
|
</body>
|
|
|
|
|
</html>
|
