gstreamer/subprojects/gst-docs/markdown/deploying/index.md

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

129 lines
4.5 KiB
Markdown
Raw Normal View History

---
2016-06-17 21:20:43 +00:00
short-description: Deploy GStreamer with your application
...
# Deploying your application
2016-05-16 14:30:34 +00:00
Once the development of your application is finished, you will need to
deploy it to the target machine, usually in the form of a package or
installer. You have several options here, and, even though this subject
is not really in the scope of this documentation, we will give some
hints to try to help you.
2016-06-17 21:20:43 +00:00
## Multiplatform vs. single-platform packaging system
2016-05-16 14:30:34 +00:00
The first choice you need to make is whether you want to deploy your
application to more than one platform. If yes, then you have the choice
to use a different packaging system for each platform, or use one that
can deliver to all platforms simultaneously. This table summarizes the
pros and cons of each option.
<table>
<colgroup>
<col width="33%" />
<col width="33%" />
<col width="33%" />
</colgroup>
<thead>
<tr class="header">
<th> </th>
<th>Pros</th>
<th>Cons</th>
</tr>
</thead>
<tbody>
<tr class="odd">
2016-06-17 21:20:43 +00:00
<td><p><strong>Multiplatform packaging system</strong></p>
<p>The same system is used to package your application for all platforms</p></td>
2016-05-16 14:30:34 +00:00
<td><ul>
<li><p>You only need to develop your packaging system once, and it works for all supported platforms.</p></li>
</ul></td>
<td><ul>
<li>On some platforms, the packaging system might impose artificial restrictions inherited from the other platforms.</li>
</ul></td>
</tr>
<tr class="even">
<td><p><strong>Single-platform packaging system</strong></p>
<p>Your application is packaged using a different system on each platform.</p></td>
<td><ul>
2016-06-17 21:20:43 +00:00
<li><p>You can make use of all the advantages each packaging system can offer.</p>
</li>
2016-05-16 14:30:34 +00:00
</ul></td>
<td><ul>
2016-06-17 21:20:43 +00:00
<li><p>You need to develop a new packaging system for each supported platform.</p></li>
2016-05-16 14:30:34 +00:00
</ul></td>
</tr>
</tbody>
</table>
2016-06-17 21:20:43 +00:00
GStreamer itself supports many different platforms (Linux, iOS, Android, Mac
OS X, Windows, etc) and has been built using a multiplatform packaging
2016-05-16 14:30:34 +00:00
system named **Cerbero**, which is available for you to use, should you
choose to go down this route.
2016-06-17 21:20:43 +00:00
## Shared vs. private GStreamer deployment
2016-05-16 14:30:34 +00:00
2016-06-17 21:20:43 +00:00
You can install GStreamer in the target machine in the same way
2016-05-16 14:30:34 +00:00
you installed it in your development machine, you can deploy it
privately, or you can even customize it before deploying. Here you have
a few options:
<table>
<colgroup>
<col width="33%" />
<col width="33%" />
<col width="33%" />
</colgroup>
<thead>
<tr class="header">
2016-06-17 21:20:43 +00:00
<th></th>
2016-05-16 14:30:34 +00:00
<th>Pros</th>
<th>Cons</th>
</tr>
</thead>
<tbody>
<tr class="odd">
2016-06-17 21:20:43 +00:00
<td><p><strong>Shared GStreamer</strong></p>
<p>GStreamer is installed independently of your application, as a prerequisite, in a common place in the target computer (<code>C:\Program Files</code>, for example). You application uses an environment variable to locate it.</p></td>
2016-05-16 14:30:34 +00:00
<td><ul>
2016-06-17 21:20:43 +00:00
<li>If more than one application in the target computer uses GStreamer, it is installed only once and shared, reducing disk usage.</li>
2016-05-16 14:30:34 +00:00
</ul></td>
<td><ul>
2016-06-17 21:20:43 +00:00
<li>Tampering or corruption of the shared GStreamer installation can make your application fail.</li>
2016-05-16 14:30:34 +00:00
</ul></td>
</tr>
<tr class="even">
2016-06-17 21:20:43 +00:00
<td><p><strong>Private GStreamer with dynamic linking</strong></p>
<p>Your application deploys GStreamer to a private folder.</p></td>
2016-05-16 14:30:34 +00:00
<td><ul>
2016-06-17 21:20:43 +00:00
<li>Your GStreamer is independent of other applications, so it does not get corrupted if other applications mess with their installations.</li>
2016-05-16 14:30:34 +00:00
</ul></td>
<td><ul>
2016-06-17 21:20:43 +00:00
<li>If multiple applications in the target computer use GStreamer, it wont be shared, consuming more disk space.</li>
2016-05-16 14:30:34 +00:00
</ul></td>
</tr>
<tr class="odd">
2016-06-17 21:20:43 +00:00
<td><p><strong>Private GStreamer with static linking</strong></p>
<p>Your application links statically against GStreamer, so it effectively becomes part of your application binary.</p></td>
2016-05-16 14:30:34 +00:00
<td><ul>
2016-06-17 21:20:43 +00:00
<li>Your GStreamer is independent of other applications, so it does not get corrupted if other applications mess with their installations.</li>
<li>Deployment for ordinary users is easier as you have fewer files.</li>
<li>This is your only choice on iOS.</li>
2016-05-16 14:30:34 +00:00
</ul></td>
<td><ul>
2016-06-17 21:20:43 +00:00
<li>If multiple applications in the target computer use GStreamer, it wont be shared, consuming more disk space.</li>
<li>You need to provide the required files for your users to re-link your application against a modified GStreamer as required by the license.</li>
2016-05-16 14:30:34 +00:00
</ul></td>
</tr>
</tbody>
</table>
The following pages give further directions for some of the above
options.
- Platform-specific packaging methods:
- For [Mac OS X](deploying/mac-osx.md)
- For [Windows](deploying/windows.md)
2016-05-16 14:30:34 +00:00
- [Multiplatform deployment using
Cerbero](deploying/multiplatform-using-cerbero.md)