Embedding distribution information

## Introduction

This is the Embedding distribution of Mozilla. It serves as a reference and smoketest distribution to demonstrate a typical subset of Mozilla needed to embed it into another application. The distribution contains sample applications for testing and development purposes.

Please note the phrase typical subset! Your application may need more or less functionality than is found in this distribution. If this is the case, then take a look at the build scripts in mozilla/embedding/config to see how this distribution was constructed.

## Where can I find more information about embedding?

Mozilla.org - http://www.mozilla.org/.

The Embedding project page - http://www.mozilla.org/projects/embedding/. This page should serve as your main point of information for learning how to embed Mozilla in your own applications.

The Embedding Frequently Asked Questions (FAQ) page - http://www.mozilla.org/projects/embedding/faq.html.

The Embedding newsgroup - news:netscape.public.mozilla.embedding.

The Embedding QA page - http://www.mozilla.org/quality/embed/.

Instructions for building Mozilla (including Embedding) - http://www.mozilla.org/build/.

Instructions for fetching Mozilla source code (including Embedding) - http://www.mozilla.org/source.html.

## Contents

The distribution contains, libraries, resources and chrome. All of this is a subset of Mozilla, repackaged for embedding. The layout follows the usual Mozilla directory, i.e.

- ./ - Test applications, launch scripts and core libraries (xpcom, nspr etc.)
- ./components/ - XPCOM components (network, graphics, layout, content, etc.).
- ./chrome/ - chrome files. In embedding most of the chrome has been re-packaged into a single embed.jar file to make it more manageable.
- ./res/ - miscellaneous rendering and parser files.
- ./defaults/ - default preference settings

### Unix

#### TestGtkEmbed

A simple browser application built using the GTK+ Browser Widget.

#### GTK+ Browser Widget

A GTK+ widget for embedding Mozilla into GTK+/GNOME applications such as Galeon. More information about the widget may be found here http://www.mozilla.org/unix/gtk-embedding.html.

### Windows

#### MFCEmbed

A complete browser application written in MFC and the Gecko embedding APIs. This application demonstrates and exercises the functionality necessary to put together a fully featured browser using Gecko.

#### Mozilla ActiveX Control

An ActiveX browser control built with the embedding APIs. You may use the control to embed a browser inside applications written in VB, Delphi etc. More information about the control including installation instructions may be found at http://www.iol.ie/~locka/mozilla/mozilla.htm.

### Macintosh

There is no Macintosh distribution at present, though an embedding test application PPEmbed is built as part of a standard Mac build. Work on Fizilla Mach may also yield a Mac embedding distribution in the future.

## Installation and Usage

### Unix

1. Untar the embedding distribution into an empty directory of your choice.
2. From the command-line, cd into the directory and type './run-mozilla.sh ./TestGtkEmbed'

### Windows

1. Unzip the embedding distribution into an empty directory of your choice.
2. Double-click on mfcembed.exe