UDN
Search public documentation:

UnrealMacPackager
日本語訳
中国翻译
한국어

Interested in the Unreal Engine?
Visit the Unreal Technology site.

Looking for jobs and company info?
Check out the Epic games site.

Questions about support via UDN?
Contact the UDN Staff

UE3 Home > Mac Platform > MacPackager Tool

MacPackager Tool


Overview


The MacPackager tool is used to package UE3 applications to run on Mac. It also handles configuration and installation of signing certificates, as well as signing the app for the Mac App Store.

Command Line Interface


The tool can be launched from the command line with no arguments, which launches as a graphical application, or with arguments in the following format:

MacPackager Command GameName Configuration [ Languages ]

Where:

Command
The primary mode of the tool. See Commands for descriptions of the various modes.
GameName
The name of the directory (e.g., UDKGame) for the game being packaged
Configuration
The build configuration of the game being packaged (e.g., Debug, Release, Shipping)
[ Languages ]
An optional plus-separated list of languages to use. Default is INT.

Commands

packageapp
Creates and packages an application bundle that is ready to unzip and run on a Mac.
packagemas
Creates and packages an application bundle that is ready to submit to the Mac App Store.
deploy
Deploys a previously created zip file with application bundle to selected destination folder. The zip name is automatically chosen based on GameName and Configuration.
gui
Brings up the Unreal Mac Configuration Wizard with the Basic Settings tab selected. See Basic Settings.
guimas
Brings up the Unreal Mac Configuration Wizard with the Mac App Store tab selected. See Mac App Store Settings.

Unreal Mac Configuration Wizard


The Unreal Mac Configuration Wizard is the graphical interface for the MacPackager tool. It provides access to all of the settings of the MacPackager, such as contents of Info.plist, destination folder for deployment, game's icon, but also allows installing the Mac App Store certificate that will be used for signing the application.

Accessing Unreal Mac Configuration Wizard

The Unreal Mac Configuration Wizard can be launched directly from within the Unreal Frontend application by clicking the Settings... button.

ufe_settingsbuttonnodeploy.jpg

Clicking this button will open the configuration tool allowing you to initially configure your Mac application or to update it should it be necessary during development.

Configuration Wizard Interface

The Unreal Mac Configuration Wizard interface consists of two tabs, the Basic Settings tab which is always visible and the Mac App Store Settings tab which is only available when the configuration wizard is run int he Mac App Store mode, each containing specialized functionality for different parts of the deployment process.

The interface also contains two buttons that are always available:

Button Description
button_cancel.jpg Closes the configuration wizard, without continuing the packaging process if it was in progress.
button_ready.jpg Closes the configuration wizard and continues the packaging process if it was in progress.

The tabs of the configuration wizard are detailed below.

Basic Settings

The Basic Settings tab allows you to set up your game for development and testing on the Mac platform.

tab_basic.jpg

Field Description
Bundle Name This is a name shown below the app's icon in Finder as well as in app's menu bar. (Example: UDK Game)
Bundle Identifier Identifier for the application bundle. If packaging for Mac App Store, this should match the bundle identifier of the App ID created on Apple's Developer website previously. (Example: com.EpicGames.UDKGame)
Destination path for deployment This is a path where the resulting application archive will be copied to during deployment.
Icon It's a path to the ICNS file with an icon that should be used for the app. If empty, default UDK icon will be used.

Mac App Store Settings

The Mac App Store Settings tab contains a tool for importing a 3rd Party Mac Developer Application certificate that's needed for signing the app for the Mac App Store.

tab_mas.jpg

Button Description
button_import.jpg Imports a development certificate previously downloaded from Apple's Developer website or a .p12 file exported from Keychain Access.