BridgeSupport
Clone or download
Pull request Compare This branch is 230 commits ahead of mobiruby:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
exceptions-universal-darwin10.0
exceptions
include
package.pmdoc
swig
test
.gitignore
.ruby-version
BridgeSupport.5
BridgeSupport.dtd
COPYRIGHT
Gemfile
Gemfile.lock
INSTALL
Makefile
README.md
build.rb
build_for_all_platforms.sh
clang.patch
gen_bridge_metadata.1
gen_bridge_metadata.rb
sort.rb
tar-chown-root.pl

README.md

BridgeSupport

(Imported from http://code.metager.de/source/xref/apple/BridgeSupport.)

BridgeSupport files are XML files that describe the API symbols of frameworks or libraries that cannot be introspected at runtime.

These are generally ANSI C symbols that are non-object-oriented items such as constants, enumerations, structures, and functions but can also include some additional information about classes, methods, and informal protocols.

BridgeSupport files are a major component of the Objective-C bridges (RubyCocoa, PyObjC) and languages (MacRuby) which permit Cocoa development.

BridgeSupport comes with pre-generated files for all the system frameworks, as well as a tool that allows you to generate files for 3rd party frameworks or libraries. The sources are covered under a BSD license.

BridgeSupport has shipped in Mac OS X since version 10.5, Leopard. This project hosts development versions of BridgeSupport. Developers are encouraged to download the sources and report problems.

Most recently, BridgeSupport has been rewritten to use the clang parser and provide more complete coverage of all APIs on the system. Please see the Releases page for more information

Requirements

  • cmake
  • subversion

You can install cmake and subversion with following command.

$ brew install cmake subversion

Using the Metadata Generator

The metadata generator, as known as gen_bridge_metadata, is documented in a manual page. After having installed the project in your system, you can display the documentation:

$ man gen_bridge_metadata

About the BridgeSupport Format

Likewise the generator, the BridgeSupport XML format is documented in a manual page.

$ man BridgeSupport

There is also a DTD file available, that should be installed as /System/Library/DTDs/BridgeSupport.dtd.