mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-11-27 04:01:08 +00:00
142 lines
7.1 KiB
Markdown
142 lines
7.1 KiB
Markdown
# GStreamer SDK documentation : Installing on Mac OS X
|
||
|
||
This page last changed on Jun 12, 2013 by xartigas.
|
||
|
||
# Prerequisites
|
||
|
||
To develop applications using the GStreamer SDK for OS X you will need
|
||
OS X Snow Leopard (10.6) or later and
|
||
[XCode 3.2.6](https://developer.apple.com/devcenter/mac/index.action) or
|
||
later.
|
||
|
||
The recommended system is [Mac OS X
|
||
Lion](http://www.apple.com/macosx/) with
|
||
[XCode 4](https://developer.apple.com/xcode/)
|
||
|
||
Installing the SDK for 32-bits platforms requires approximately 145MB of
|
||
free disk space for the runtime and 193MB for the development files.
|
||
|
||
Installing the SDK for 64-bits platforms requires approximately 152MB of
|
||
free disk space for the runtime and 223MB for the development files.
|
||
|
||
# Download and install the SDK
|
||
|
||
There are 3 sets of files in the SDK:
|
||
|
||
- The runtime files are needed to run GStreamer applications. You
|
||
probably want to distribute these files with your application (or
|
||
the installer below).
|
||
- The development files are **additional** files you need to create
|
||
GStreamer applications.
|
||
- Mac OS X packages that you can use
|
||
with [PackageMaker](https://developer.apple.com/library/mac/#documentation/DeveloperTools/Conceptual/PackageMakerUserGuide/Introduction/Introduction.html)
|
||
to deploy GStreamer with your application
|
||
|
||
Get **both the runtime and the development installers** from here:
|
||
|
||
<table>
|
||
<colgroup>
|
||
<col width="100%" />
|
||
</colgroup>
|
||
<tbody>
|
||
<tr class="odd">
|
||
<td>Universal</td>
|
||
</tr>
|
||
<tr class="even">
|
||
<td><ul>
|
||
<li><a href="http://cdn.gstreamer.com/osx/universal/gstreamer-sdk-2013.6-universal.pkg" class="external-link">GStreamer SDK 2013.6 (Congo) for Mac OS X (Runtime)</a> - <a href="http://www.freedesktop.org/software/gstreamer-sdk/data/packages/osx/universal/gstreamer-sdk-2013.6-universal.pkg" class="external-link">mirror</a> - <a href="http://cdn.gstreamer.com/osx/universal/gstreamer-sdk-2013.6-universal.pkg.md5" class="external-link">md5</a> - <a href="http://cdn.gstreamer.com/osx/universal/gstreamer-sdk-2013.6-universal.pkg.sha1" class="external-link">sha1</a></li>
|
||
<li><a href="http://cdn.gstreamer.com/osx/universal/gstreamer-sdk-devel-2013.6-universal.pkg" class="external-link">GStreamer SDK 2013.6 (Congo) for Mac OS X (Development files)</a> - <a href="http://www.freedesktop.org/software/gstreamer-sdk/data/packages/osx/universal/gstreamer-sdk-devel-2013.6-universal.pkg" class="external-link">mirror</a> - <a href="http://cdn.gstreamer.com/osx/universal/gstreamer-sdk-devel-2013.6-universal.pkg.md5" class="external-link">md5</a> - <a href="http://cdn.gstreamer.com/osx/universal/gstreamer-sdk-devel-2013.6-universal.pkg.sha1" class="external-link">sha1</a></li>
|
||
<li><a href="http://cdn.gstreamer.com/osx/universal/gstreamer-sdk-2013.6-universal-packages.dmg" class="external-link">GStreamer SDK 2013.6 (Congo) for Mac OS X (Deployment Packages)</a> - <a href="http://www.freedesktop.org/software/gstreamer-sdk/data/packages/osx/universal/gstreamer-sdk-2013.6-universal-packages.dmg" class="external-link">mirror</a> - <a href="http://cdn.gstreamer.com/osx/universal/gstreamer-sdk-2013.6-universal-packages.dmg.md5" class="external-link">md5</a> - <a href="http://cdn.gstreamer.com/osx/universal/gstreamer-sdk-2013.6-universal-packages.dmg.sha1" class="external-link">sha1</a></li>
|
||
</ul></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
|
||
<table>
|
||
<tbody>
|
||
<tr class="odd">
|
||
<td><img src="images/icons/emoticons/warning.png" width="16" height="16" /></td>
|
||
<td><p>On Mac OS X 10.6 (Snow Leopard) you have to install Python 2.7 manually. It is included in later versions of OS X already. You can get it from <a href="http://www.python.org/getit" class="external-link">here</a>.</p></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
|
||
<table>
|
||
<tbody>
|
||
<tr class="odd">
|
||
<td><img src="images/icons/emoticons/warning.png" width="16" height="16" /></td>
|
||
<td><p>Due to the size of these files, usage of a <a href="http://en.wikipedia.org/wiki/Download_manager" class="external-link">Download Manager</a> is <strong>highly recommended</strong>. Take a look at <a href="http://en.wikipedia.org/wiki/Comparison_of_download_managers" class="external-link">this list</a> if you do not have one installed. If, after downloading, the installer reports itself as corrupt, chances are that the connection ended before the file was complete. A Download Manager will typically re-start the process and fetch the missing parts.</p></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
|
||
The downloads are [Apple Disk Images
|
||
(.dmg)](http://en.wikipedia.org/wiki/Apple_Disk_Image) containing an
|
||
[Installer Package
|
||
(.pkg)](http://en.wikipedia.org/wiki/Installer_%28Mac_OS_X%29). Double
|
||
click in the installer to start the installation process.
|
||
|
||
These are some paths of the GStreamer framework that you might find
|
||
useful:
|
||
|
||
- /Library/Frameworks/GStreamer.framework/: Framework's root path
|
||
- /Library/Frameworks/GStreamer.framework/Versions: path with all the
|
||
versions of the framework
|
||
- /Library/Frameworks/GStreamer.framework/Versions/Current: link to
|
||
the current version of the framework
|
||
- /Library/Frameworks/GStreamer.framework/Headers: path with the
|
||
development headers
|
||
- /Library/Frameworks/GStreamer.framework/Commands: link to the
|
||
commands provided by the framework, such as gst-inspect-0.10 or
|
||
gst-launch-0.10
|
||
|
||
For more information on OS X Frameworks anatomy, you can consult the
|
||
following [link](https://developer.apple.com/library/mac/#documentation/MacOSX/Conceptual/BPFrameworks/Concepts/FrameworkAnatomy.html)
|
||
|
||
# Configure your development environment
|
||
|
||
### Building the tutorials
|
||
|
||
The tutorial's code, along with project files and a solution file for
|
||
them all are included in the SDK. The source code and the XCode project
|
||
files are located
|
||
in `/Library/Frameworks/GStreamer.framework/Current/share/gst-sdk/tutorials.`
|
||
|
||
To start building the tutorials, create a new folder in your Documents
|
||
directory and copy the
|
||
folder `/Library/Frameworks/GStreamer.framework/Current/share/gst-sdk/tutorials`.
|
||
|
||
You can fire up XCode and load the project file.
|
||
|
||
Press the **Run **button to build and run the first tutorial. You can
|
||
switch the tutorial to build selecting one of the available schemes.
|
||
|
||
### Creating new projects
|
||
|
||
The GStreamer SDK provides a
|
||
[framework](https://developer.apple.com/library/mac/#documentation/MacOSX/Conceptual/BPFrameworks/Tasks/IncludingFrameworks.html)
|
||
that you can drag and drop to XCode to start using it, or using the
|
||
linker option ***-framework GStreamer****.*
|
||
|
||
There is a small exception to the regular use of frameworks, and you
|
||
will need to manually include the headers search
|
||
path `/Library/Frameworks/GStreamer.framework/Headers`
|
||
|
||
- XCode: Add the headers path to **Search Paths-\> Header Search
|
||
Paths**
|
||
- GCC: Using the compiler
|
||
option** -I/Library/Frameworks/GStreamer.framework/Headers**
|
||
|
||
## Attachments:
|
||
|
||
|
||
[Configurations.png](attachments/327710/2424835.png) (image/png)
|
||
|
||
[Schemes.png](attachments/327710/2424836.png) (image/png)
|
||
 [Add
|
||
files.png](attachments/327710/2424837.png) (image/png)
|
||
 [Project
|
||
Files.png](attachments/327710/2424838.png) (image/png)
|
||
|
||
Document generated by Confluence on Oct 08, 2015 10:27
|
||
|