Source

pyobjc / pyobjc / Install.html

The branch 'PyDE-vendor' does not exist.
Full commit
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>
Installation Instructions</title>
</head>
<body>
<h2>Installation Instructions</h2>
<!-- :authors: Bill Bumgarner, Ronald Oussoren -->
<h2><a name="building-the-package">Building the package</a></h2>
<p>If you're using the sources from CVS you should first download a copy of 
libffi from <a href="http://sourceforge.net/project/showfiles.php?group_id=14534">the PyObjC download site</a>.  Extract this in a convenient location
and update the variable <code><span>LIBFF_SOURCES</span></code> at the top of setup.py.  The released
version of PyObjC includes a compatible version of libffi.</p>
<p>PyObjC is build and installed using the distutils package included with Python
2.0 and beyond.  This package provides a single interface for building and
packaging the module.   To see usage documentation for the module,
issue the <code><span>--help</span></code> command:</p>
<pre>
% python setup.py --help
</pre>
<p>To see an inventory of building and packaging commands, issue the
command:</p>
<pre>
% python setup.py --help-commands
</pre>
<p>The following command will build and install the pyobjc module:</p>
<pre>
% python setup.py install
</pre>
<p>The setup.py system can also be used to create source and binary
distribution archives automatically.</p>
<p>Use <code><span>sudo</span></code> to install the pyobjc module into a the Apple supplied
python's site-packages directory on OS X 10.2 and greater:</p>
<p>% sudo python setup.py install</p>
<p>If you have multiple versions of python installed on your system, the
above will only install pyobjc for whatever version of python is the
default on the command line.   Make sure you are installing python
against the correct version of python.</p>
<p>To be able to build the wrappers for the WebKit framework (included with
Safari 1.0), you'll have to install the WebKit SDK. You can download 
this from the <a href="http://connect.apple.com">ADC website</a>.</p>
<h2><a name="examples">Examples</a></h2>
<p>The <a href="Examples/00ReadMe.html">examples directory</a> contains a number of projects that demonstrate
various features of the PyObjC bridge. The scripts at the top level of
the <a href="Examples/00ReadMe.html">examples directory</a> were mostly written to test a particular
feature of the bridge (or document a bug until a fix could be found).</p>
<p>CurrencyConverter and TableModel are both examples of standalone
Cocoa-Python applications.  To build and execute:</p>
<pre>
% cd TableModel
% python buildapp.py build
</pre>
<p>The WebServicesTool is an example of Cocoa-Python applications created via 
the Cocoa-Python project template found in the 
<code><span>ProjectBuilder</span> <span>Extras/Project</span> <span>Templates</span></code> directory.  Use Project Builder 
to build the applications.</p>
<h2><a name="project-templates">Project Templates</a></h2>
<p>The <code><span>ProjectBuilder</span> <span>Extras</span></code> directory contains additional files that can
be used with Project Builder. The directory <code><span>Specifications</span></code> contains files
that enable syntax coloring for Python files in Project Builder.</p>
<p>The <code><span>Project</span> <span>Templates</span></code> directory contains project templates for
Project Builder.  These have to be copied to
<code><span>/Developer/ProjectBuilder</span> <span>Extras/Project</span> <span>Templates/Application</span></code> before
they are useable from Project Builder.</p>
<p>There are three templates available:</p>
<ul>
<li>Cocoa-Python Application<p>A project created from this template is designed to implement standalone,
pure-Python, applications that are compatible with Apple's build of Python as
well as all other builds of python that support PyObjC.</p>
<p>When building the 'install' target, the resulting application wrapper will
included the PyObjC module and can be launched on any stock OS X 10.2 system
without requiring PyObjC to be preinstalled.</p>
</li>
<li>Cocoa-Python-ObjC Application<p>A project created from this template includes an embedded framework project
into which all compiled (Objective-C) code can be placed.  Upon launch, 
the application automatically dynamically loads the embedded framework 
containing the compiled code.</p>
<p>Each Framework's Resources directory is automatically added to sys.path.</p>
</li>
<li>Cocoa-Python Document-based Application<p>This template works like the Cocoa-Python Application template in that it
is compatible with the Apple build of Python.   It creates an application 
that uses Cocoa's Multiple Document Architecture in the same fashion as the
default Cocoa Document-based Application supplied with Project Builder.</p>
</li>
</ul>
<p>More information on project templates can be found in the Project
Builder documentation and/or release notes.</p>
</body>
</html>