You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
145 lines
3.7 KiB
145 lines
3.7 KiB
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
|
|
<html>
|
|
<head>
|
|
<title>refNum › dmgutil</title>
|
|
<!--HEAD_BEGIN-->
|
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF8">
|
|
|
|
|
|
|
|
<script type="text/javascript" src="src/js/refnum.js"></script>
|
|
|
|
<script type="text/javascript">
|
|
var _gaq = _gaq || [];
|
|
_gaq.push(['_setAccount', 'UA-19561062-1']);
|
|
_gaq.push(['_trackPageview']);
|
|
|
|
(function() {
|
|
var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
|
|
ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
|
|
var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
|
|
})();
|
|
</script>
|
|
|
|
<link type="text/css" href="src/css/refnum.css" rel=stylesheet>
|
|
<!--HEAD_END-->
|
|
</head>
|
|
<body>
|
|
|
|
<div id="content">
|
|
<!--#include virtual="/src/inc/nav.inc" -->
|
|
<script language="javascript">navSelect("dev")</script>
|
|
|
|
<a href="index.html">
|
|
<div id="page_strap_frame" style="background:url('src/img/page_strap_dmgutil.png');">
|
|
<div id="page_strap_content" style="background:url('src/img/page_strap_dmgutil.jpg'); background-repeat: no-repeat; background-position: 22px 16px;"></div></div></a>
|
|
<div id="page_body">
|
|
<div id="page_content">
|
|
|
|
|
|
|
|
<table>
|
|
<tr>
|
|
<td valign=top>
|
|
<ul id="menu">
|
|
<li class="subtitle">dmgutil</li>
|
|
<li><a href="index.html">Home</a></li>
|
|
<li><a href="licence.html">Licence</a></li>
|
|
<li><a href="version.html">Version History</a></li>
|
|
</ul>
|
|
</td>
|
|
<td valign=top>
|
|
|
|
|
|
|
|
<h1>dmgutil</h1>
|
|
<p>
|
|
dmgutil is a command line tool for creating, configuring, and compressing Mac OS X
|
|
disk images for distribution.
|
|
</p>
|
|
|
|
<p>
|
|
dmgutil allows you to automate your build process, preparing a release without pre-existing
|
|
templates or user interaction.
|
|
</p>
|
|
|
|
<p>
|
|
dmgutil can adjust the size, position, and appearance of Finder windows. It can also apply
|
|
custom icons to volumes, folders, or files and assign a license agreement.
|
|
</p>
|
|
|
|
<div class="box_button">
|
|
<a href="http://www.refnum.com/files/dmgutil.zip" class="button icon_download"><span><span class="icon"></span>Download</span></a>
|
|
<span class="padding20"> </span>
|
|
<a href="http://github.com/refnum/dmgutil" class="button icon_github"><span><span class="icon"></span>GitHub</span></a>
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
<h2>Using dmgutil</h2>
|
|
<p>
|
|
To create a new disk image for your "MyApp 1.0" release, invoke dmgutil as:
|
|
</p>
|
|
|
|
<div class="box_code_yellow">dmgutil.pl --open --volume="MyApp 1.0" myapp_1.0.dmg
|
|
</div>
|
|
|
|
<p>
|
|
Once the disk image has been populated with files, invoke dmgutil to configure it:
|
|
</p>
|
|
|
|
<div class="box_code_yellow">dmgutil.pl --set --iconsize=128 --background=flowers.jpg "/Volumes/MyApp 1.0"
|
|
dmgutil.pl --set --x=20 --y=60 --width=300 --height=200 "/Volumes/MyApp 1.0"
|
|
</div>
|
|
|
|
<p>
|
|
You can also use dmgutil to set the position of file or folder icons within the window:
|
|
</p>
|
|
|
|
<div class="box_code_yellow">dmgutil.pl --set --x=100 --y=100 "/Volumes/MyApp 1.0/Read Me.rtf"
|
|
dmgutil.pl --set --x=200 --y=100 "/Volumes/MyApp 1.0/MyApp.app"
|
|
</div>
|
|
|
|
<p>
|
|
dmgutil can also adjust the background color or toolbar visibility of the window, and
|
|
apply custom icons to the volume or its contents.
|
|
</p>
|
|
|
|
<p>
|
|
Once the volume has been prepared, compress the disk image with:
|
|
</p>
|
|
|
|
<div class="box_code_yellow">dmgutil.pl --close --volume="MyApp 1.0" myapp_1.0.dmg
|
|
</div>
|
|
|
|
<p>
|
|
By invoking dmgutil from a post-build shell script, builds can be automatically converted
|
|
into a user-friendly disk image for distribution.
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
|
|
|
|
</div>
|
|
</div>
|
|
<div id="page_footer"></div>
|
|
</div>
|
|
|
|
|
|
|
|
<!--FOOTER_BEGIN-->
|
|
<div id="footer">
|
|
Copyright © 2006-2010 <a href="http://www.refnum.com/">refNum Software</a>
|
|
</div>
|
|
<!--FOOTER_END-->
|
|
</body>
|
|
</html>
|
|
|