Data Loading...
iTunes Connect Transporter Quick Start Guide v2 Flipbook PDF
Revision History February 5, 2013— v2 Edited for style and consistency. October 23, 2012— v1 Version created. iTunes Con
110 Views
73 Downloads
FLIP PDF 127.8KB
iTunes Connect Transporter Quick Start Guide v2
2013-2-05 Apple Inc.
iTunes Connect Transporter Quick Start Guide CONFIDENTIAL
February 5, 2013
© 2013 Apple Inc. All rights reserved. No part of this publication may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, mechanical, electronic, photocopying, recording, or otherwise, without prior written permission of Apple Inc., with the following exceptions: Any person is hereby authorized to store documentation on a single computer for personal use only and to print copies of documentation for personal use provided that the documentation contains Apple’s copyright notice. The Apple logo is a trademark of Apple Inc. Use of the “keyboard” Apple logo (Option-Shift-K) for commercial purposes without the prior written consent of Apple may constitute trademark infringement and unfair competition in violation of federal and state laws. No licenses, express or implied, are granted with respect to any of the technology described in this document. Apple retains all intellectual property rights associated with the technology described in this document. This document is intended to assist iTunes Content Developers to manage and deliver content for the iTunes Store. Every effort has been made to ensure that the information in this document is accurate. Apple is not responsible for typographical errors. Apple Inc. 1 Infinite Loop Cupertino, CA 95014 408-996-1010
Even though Apple has reviewed this document, APPLE MAKES NO WARRANTY OR REPRESENTATION, EITHER EXPRESS OR IMPLIED, WITH RESPECT TO THIS DOCUMENT, ITS QUALITY, ACCURACY, MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE. AS A RESULT, THIS DOCUMENT IS PROVIDED “AS IS,” AND YOU, THE READER, ARE ASSUMING THE ENTIRE RISK AS TO ITS QUALITY AND ACCURACY. IN NO EVENT WILL APPLE BE LIABLE FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES RESULTING FROM ANY DEFECT OR INACCURACY IN THIS DOCUMENT, even if advised of the possibility of such damages THE WARRANTY AND REMEDIES SET FORTH ABOVE ARE EXCLUSIVE AND IN LIEU OF ALL OTHERS, ORAL OR WRITTEN, EXPRESS OR IMPLIED. No Apple dealer, agent, or employee is authorized to make any modification, extension, or addition to this warranty. Some states do not allow the exclusion or limitation of implied warranties or liability for incidental or consequential damages, so the above limitation or exclusion may not apply to you. This warranty gives you specific legal rights, and you may also have other rights which vary from state to state. 2
iTunes Connect Transporter Quick Start Guide CONFIDENTIAL
February 5, 2013
Table of Contents Revision History ................................................................................................................................4 Introduction ......................................................................................................................................5 System Requirements .....................................................................................................................5 Installing Transporter ......................................................................................................................5 Using Transporter .............................................................................................................................6
Using Lookup Mode ..................................................................................................................................6 Using Verify Mode ......................................................................................................................................6 Using Upload Mode ...................................................................................................................................7
Appendix ............................................................................................................................................8
3
iTunes Connect Transporter Quick Start Guide CONFIDENTIAL
February 5, 2013
Revision History February 5, 2013— v2 Edited for style and consistency. October 23, 2012— v1 Version created.
4
iTunes Connect Transporter Quick Start Guide CONFIDENTIAL
February 5, 2013
Introduction This guide can help you install and use Transporter, Apple’s command-line tool used for sending App Store packages (.itmsp) to the App Store. App Store packages can contain In-App Purchases and Game Center metadata. For more information on App Store packages, see the App Metadata Specification available from the Manage Your Applications module on iTunes Connect.
System Requirements Transporter requires a Mac with a 64-bit processor, OS X v10.6 or later, at least 1GB of RAM, and 100 MB of available disk space.
Installing Transporter If you are using Xcode or Application Loader, you already have Transporter installed. You can find Transporter in the following location: Xcode: /Applications/Xcode.app/Contents/Applications/Application Loader.app/Contents/MacOS/itms/ bin Application Loader: /Developer/Applications/Utilities/Application Loader.app/Contents/MacOS/itms/bin If you do not have Transporter installed, download Transporter and follow the installation instructions. After installing Transporter successfully, you can find the app in /usr/local/itms/bin directory. You can also add a TRANSPORTER_HOME environment variable to easily navigate to the folder. To do so, add the following to your .bash_profile: export TRANSPORTER_HOME=[file path to Transporter] For example, if you have Xcode installed, add the following to the .bash_profile: export TRANSPORTER_HOME=`xcode-select --print-path`/../ Applications/Application\ Loader.app/Contents/MacOS/itms/bin
5
iTunes Connect Transporter Quick Start Guide CONFIDENTIAL
February 5, 2013
Using Transporter To start Transporter, use the iTMSTransporter command in the Terminal app. You must use the iTMSTransporter command in the directory where Transporter is installed. To use Transporter, you must have an iTunes Connect account with the Admin or Technical role.
Using Lookup Mode You can use lookup mode to retrieve your app’s current metadata. Lookup mode will create an App Store package at the set destination. The package name will be the app's SKU with the .itmsp extension. For example, if your app’s SKU is “myapp1” on iTunes Connect, your filename would be myapp1.itmsp. The metadata.xml file within the App Store package contains the app's metadata. To initiate lookup mode, use the following command: $ iTMSTransporter -m lookupMetadata -u [iTunes Connect user name] -p [iTunes Connect password] -vendor_id [App SKU] destination [destination path for App Store Package] To restrict lookup to a certain type of metadata, include: -subitemtype [InAppPurchase | GameCenterLeaderboard | GameCenterAchievement] To restrict lookup to certain items, use -subitemids [items]. The items value is a comma-separated list of up to 1000 In-App Purchase product IDs, Game Center leaderboard IDs, or Game Center achievement IDs. If you use the -subitemids option, you must also specify the -subitemtype option. The -subitemtype and -subitemids options are required if your app has more than 1000 In-App Purchases. For example, you can look up metadata for: • All In-App Purchases, using -subitemtype InAppPurchase • Two specific In-App Purchases, using -subitemtype InAppPurchase -subitemids com.mycompany.IAP01,com.mycompany.IAP02 • Two specific Game Center Leaderboards, using -subitemtype GameCenterLeaderboard -subitemids com.mycompany.Leaderboard01,com.mycompany.Leaderboard02 To log the output in a log file, include the optional -o [output file] command.
Using Verify Mode Verify mode validates your App Store package, including metadata and assets, before delivering it to the App Store. In verify mode, no changes will be made to your app's live metadata. To initiate verify mode, use the following command: 6
iTunes Connect Transporter Quick Start Guide CONFIDENTIAL
February 5, 2013
$ iTMSTransporter -m verify -f [path to App Store Package] -u [iTunes Connect user name] -p [iTunes Connect password] To log the output in a log file, include the optional -o [output file] command.
Using Upload Mode Upload mode submits your App Store package to the App Store. Before submitting, ensure that the package includes all assets. To initiate upload mode, use the following command: $ iTMSTransporter -m upload -f [path to App Store Package] -u [iTunes Connect user name] -p [iTunes Connect password] To log the output in a log file, include the optional -o [output file] command.
7
iTunes Connect Transporter Quick Start Guide CONFIDENTIAL
February 5, 2013
Appendix The table below includes all the details for the different Transporter servers. If you are using a firewall, you may need to configure it. Server
IP Address
TCP Port
UDP Port
Notes
itmsdav.apple.com
17.152.19.125
443
n/a
DAV only
contentdelivery.itunes.apple.com
17.152.19.127
443
n/a
HTTPS
vgr101.apple.com
17.152.249.51
33001
33001-33500
Aspera only
vgr102.apple.com
17.152.249.52
33001
33001-33500
Aspera only
vgr103.apple.com
17.152.249.53
33001
33001-33500
Aspera only
vgr104.apple.com
17.152.249.54
33001
33001-33500
Aspera only
vgr105.apple.com
17.152.249.55
33001
33001-33500
Aspera only
vgr106.apple.com
17.152.249.56
33001
33001-33500
Aspera only
vgr107.apple.com
17.152.249.57
33001
33001-33500
Aspera only
vgr108.apple.com
17.152.249.58
33001
33001-33500
Aspera only
vgr301.apple.com
17.172.190.141
33001
33001-33500
Aspera only
vgr302.apple.com
17.172.190.142
33001
33001-33500
Aspera only
vgr303.apple.com
17.172.190.143
33001
33001-33500
Aspera only
vgr304.apple.com
17.172.190.144
33001
33001-33500
Aspera only
vgr305.apple.com
17.172.190.145
33001
33001-33500
Aspera only
vgr306.apple.com
17.172.190.146
33001
33001-33500
Aspera only
vgr307.apple.com
17.172.190.147
33001
33001-33500
Aspera only
vgr308.apple.com
17.172.190.148
33001
33001-33500
Aspera only
sgr201.apple.com
17.152.249.101
44001
44001-44500
Signiant only
sgr202.apple.com
17.152.249.102
44001
44001-44500
Signiant only
sgr203.apple.com
17.152.249.103
44001
44001-44500
Signiant only
sgr204.apple.com
17.152.249.104
44001
44001-44500
Signiant only
sgr205.apple.com
17.152.249.105
44001
44001-44500
Signiant only
sgr206.apple.com
17.152.249.106
44001
44001-44500
Signiant only
8
iTunes Connect Transporter Quick Start Guide CONFIDENTIAL
Server
IP Address
sgr207.apple.com
17.152.249.107
sgr208.apple.com
February 5, 2013
TCP Port
UDP Port
Notes
44001
44001-44500
Signiant only
17.152.249.108
44001
44001-44500
Signiant only
sgr401.apple.com
17.172.190.101
44001
44001-44500
Signiant only
sgr402.apple.com
17.172.190.102
44001
44001-44500
Signiant only
sgr403.apple.com
17.172.190.103
44001
44001-44500
Signiant only
sgr404.apple.com
17.172.190.104
44001
44001-44500
Signiant only
sgr405.apple.com
17.172.190.105
44001
44001-44500
Signiant only
sgr406.apple.com
17.172.190.106
44001
44001-44500
Signiant only
sgr407.apple.com
17.172.190.107
44001
44001-44500
Signiant only
sgr408.apple.com
17.172.190.108
44001
44001-44500
Signiant only
9