Implement publish command for iOS

Publishes to itunesconnect via Xcode's iTMS Transporter tool.
Introduce itmstransporter-service to talk to the tool along with minor refactorings in the build process, allowing for custom setting of CODE_SIGN_IDENTITY and PROVISIONING_PROFILE during build.

Author: Mitko-Kerezov

lib/bootstrap.ts

@@ -52,6 +52,11 @@ $injector.requireCommand("test|ios", "./commands/test");
 $injector.requireCommand("test|init", "./commands/test-init");
 $injector.requireCommand("dev-generate-help", "./commands/generate-help");
 
+$injector.requireCommand("appstore|*list", "./commands/appstore-list");
+$injector.requireCommand("appstore|upload", "./commands/appstore-upload");
+$injector.requireCommand("publish|ios", "./commands/appstore-upload");
+$injector.require("itmsTransporterService", "./services/itmstransporter-service");
+
 $injector.require("npm", "./node-package-manager");
 $injector.require("npmInstallationManager", "./npm-installation-manager");
 $injector.require("lockfile", "./lockfile");

lib/commands/appstore-list.ts

@@ -0,0 +1,44 @@
+///<reference path="../.d.ts"/>
+"use strict";
+
+import { createTable } from "../common/helpers";
+import {StringCommandParameter} from "../common/command-params";
+
+export class ListiOSApps implements ICommand {
+	constructor(private $injector: IInjector,
+		private $itmsTransporterService: IITMSTransporterService,
+		private $logger: ILogger,
+		private $prompter: IPrompter,
+		private $stringParameterBuilder: IStringParameterBuilder) { }
+
+	public allowedParameters: ICommandParameter[] = [new StringCommandParameter(this.$injector), new StringCommandParameter(this.$injector)];
+
+	public execute(args: string[]): IFuture<void> {
+		return (() => {
+			let username = args[0],
+				password = args[1];
+
+			if(!username) {
+				username = this.$prompter.getString("Apple ID", { allowEmpty: false }).wait();
+			}
+
+			if(!password) {
+				password = this.$prompter.getPassword("Apple ID password").wait();
+			}
+
+			let iOSApplications = this.$itmsTransporterService.getiOSApplications({username, password}).wait();
+
+			if (!iOSApplications || !iOSApplications.length) {
+				this.$logger.out("Seems you don't have any applications yet.");
+			} else {
+				let table: any = createTable(["Application Name", "Bundle Identifier", "Version"], iOSApplications.map(element => {
+					return [element.name, element.bundleId, element.version];
+				}));
+
+				this.$logger.out(table.toString());
+			}
+		}).future<void>()();
+	}
+}
+
+$injector.registerCommand("appstore|*list", ListiOSApps);

lib/commands/appstore-upload.ts

@@ -0,0 +1,71 @@
+///<reference path="../.d.ts"/>
+"use strict";
+
+import {StringCommandParameter} from "../common/command-params";
+import * as path from "path";
+
+export class PublishIOS implements ICommand {
+	constructor(private $errors: IErrors,
+		private $fs: IFileSystem,
+		private $hostInfo: IHostInfo,
+		private $injector: IInjector,
+		private $itmsTransporterService: IITMSTransporterService,
+		private $logger: ILogger,
+		private $options: IOptions,
+		private $prompter: IPrompter,
+		private $stringParameterBuilder: IStringParameterBuilder) { }
+
+	public allowedParameters: ICommandParameter[] = [new StringCommandParameter(this.$injector), new StringCommandParameter(this.$injector),
+			new StringCommandParameter(this.$injector), new StringCommandParameter(this.$injector)];
+
+	public execute(args: string[]): IFuture<void> {
+		return (() => {
+			let username = args[0],
+				password = args[1],
+				mobileProvisionIdentifier = args[2],
+				codeSignIdentity = args[3],
+				ipaFilePath = this.$options.ipa ? path.resolve(this.$options.ipa) : null,
+				bundleId = this.$itmsTransporterService.getBundleIdentifier(ipaFilePath).wait();
+
+			if(!username) {
+				username = this.$prompter.getString("Apple ID", { allowEmpty: false }).wait();
+			}
+
+			if(!password) {
+				password = this.$prompter.getPassword("Apple ID password").wait();
+			}
+
+			let iOSApplication = this.$itmsTransporterService.getiOSApplication(username, password, bundleId).wait();
+
+			if(!mobileProvisionIdentifier && !ipaFilePath) {
+				this.$logger.warn("No mobile provision identifier set. A default mobile provision will be used. You can set one in app/App_Resources/iOS/build.xcconfig");
+			}
+
+			if(!codeSignIdentity && !ipaFilePath) {
+				this.$logger.warn("No code sign identity set. A default code sign identity will be used. You can set one in app/App_Resources/iOS/build.xcconfig");
+			}
+
+			this.$options.release = true;
+			this.$itmsTransporterService.upload({
+				appId: iOSApplication.adamId,
+				username,
+				password,
+				mobileProvisionIdentifier,
+				codeSignIdentity,
+				ipaFilePath,
+				verboseLogging: this.$logger.getLevel() === "TRACE"
+			}).wait();
+		}).future<void>()();
+	}
+
+	public canExecute(args: string[]): IFuture<boolean> {
+		return (() => {
+			if (!this.$hostInfo.isDarwin) {
+				this.$errors.failWithoutHelp("This command is only available on Mac OS X.");
+			}
+
+			return true;
+		}).future<boolean>()();
+	}
+}
+$injector.registerCommand(["publish|ios", "appstore|upload"], PublishIOS);

lib/common

@@ -25,3 +25,20 @@ export class ReleaseType {
 	static PREPATCH = "prepatch";
 	static PRERELEASE = "prerelease";
 }
+
+export class ITMSConstants {
+	static ApplicationMetadataFile = "metadata.xml";
+	static VerboseLoggingLevels = {
+		Informational: "informational",
+		Verbose: "detailed"
+	};
+	static iTMSExecutableName = "iTMSTransporter";
+	static iTMSDirectoryName = "itms";
+}
+
+class ItunesConnectApplicationTypesClass implements IiTunesConnectApplicationType {
+	public iOS = "iOS App";
+	public Mac = "Mac OS X App";
+}
+
+export let ItunesConnectApplicationTypes = new ItunesConnectApplicationTypesClass();

lib/constants.ts

@@ -58,6 +58,7 @@ interface ILiveSyncService {
 }
 
 interface IOptions extends ICommonOptions {
+	ipa: string;
 	frameworkPath: string;
 	frameworkName: string;
 	framework: string;
@@ -88,6 +89,77 @@ interface IInitService {
 	initialize(): IFuture<void>;
 }
 
+/**
+ * Describes standard username/password type credentials.
+ */
+interface ICredentials {
+	username: string;
+	password: string;
+}
+
+/**
+ * Describes properties needed for uploading a package to iTunes Connect
+ */
+interface IITMSData extends ICredentials {
+	/**
+	 * The application's Apple ID. It can be found on itunesconnect.apple.com.
+	 * @type {string}
+	 */
+	appId: string;
+	/**
+	 * The identifier of the mobile provision used for building. Note that this will override the same option set through .xcconfig files.
+	 * @type {string}
+	 */
+	mobileProvisionIdentifier?: string;
+	/**
+	 * The Code Sign Identity used for building. Note that this will override the same option set through .xcconfig files.
+	 * @type {string}
+	 */
+	codeSignIdentity?: string;
+	/**
+	 * Path to a .ipa file which will be uploaded. If set that .ipa will be used and no build will be issued.
+	 * @type {string}
+	 */
+	ipaFilePath?: string;
+	/**
+	 * Specifies whether the logging level of the itmstransporter command-line tool should be set to verbose.
+	 * @type {string}
+	 */
+	verboseLogging?: boolean;
+}
+
+/**
+ * Used for communicating with Xcode's iTMS Transporter tool.
+ */
+interface IITMSTransporterService {
+	/**
+	 * Uploads an .ipa package to iTunes Connect.
+	 * @param  {IITMSData}     data Data needed to upload the package
+	 * @return {IFuture<void>}
+	 */
+	upload(data: IITMSData): IFuture<void>;
+	/**
+	 * Queries Apple's content delivery API to get the user's registered iOS applications.
+	 * @param  {ICredentials}                               credentials Credentials for authentication with iTunes Connect.
+	 * @return {IFuture<IItunesConnectApplication[]>}          The user's iOS applications.
+	 */
+	getiOSApplications(credentials: ICredentials): IFuture<IiTunesConnectApplication[]>;
+	/**
+	 * Gets iTunes Connect application corresponding to the given bundle identifier.
+	 * @param  {string}                             username For authentication with iTunes Connect.
+	 * @param  {string}                             password For authentication with iTunes Connect.
+	 * @param  {string}                             bundleId Application's Bundle Identifier
+	 * @return {IFuture<IiTunesConnectApplication>}          The iTunes Connect application.
+	 */
+	getiOSApplication(username: string, password: string, bundleId: string) : IFuture<IiTunesConnectApplication>;
+	/**
+	 * Gets the application's bundle identifier. If ipaFileFullPath is provided will extract the bundle identifier from the .ipa file.
+	 * @param  {string}          ipaFileFullPath Optional full path to .ipa file
+	 * @return {IFuture<string>}                 Application's bundle identifier.
+	 */
+	getBundleIdentifier(ipaFileFullPath?: string): IFuture<string>;
+}
+
 /**
  * Provides access to information about installed Android tools and SDKs versions.
  */

lib/declarations.ts

@@ -52,6 +52,20 @@ interface IBuildConfig {
 	architectures?: string[];
 }
 
+/**
+ * Describes iOS-specific build configuration properties
+ */
+interface IiOSBuildConfig extends IBuildConfig {
+	/**
+	 * Identifier of the mobile provision which will be used for the build. If not set a provision will be selected automatically if possible.
+	 */
+	mobileProvisionIdentifier?: string;
+	/**
+	 * Code sign identity used for build. If not set iPhone Developer is used as a default when building for device.
+	 */
+	codeSignIdentity?: string;
+}
+
 interface IPlatformProjectService {
 	platformData: IPlatformData;
 	validate(): IFuture<void>;

lib/definitions/project.d.ts

@@ -12,6 +12,7 @@ export class Options extends commonOptionsLibPath.OptionsBase {
 		$staticConfig: IStaticConfig,
 		$hostInfo: IHostInfo) {
 		super({
+			ipa: { type: OptionType.String },
 			frameworkPath: { type: OptionType.String },
 			frameworkName: { type: OptionType.String },
 			framework: { type: OptionType.String },

lib/options.ts

@@ -94,7 +94,7 @@ export class InitService implements IInitService {
 				return defaultAppId;
 			}
 
-			return this.$prompter.getString("Id:", () => defaultAppId).wait();
+			return this.$prompter.getString("Id:", { defaultAction: () => defaultAppId }).wait();
 		}).future<string>()();
 	}
 

lib/services/init-service.ts

@@ -157,7 +157,7 @@ export class IOSProjectService extends projectServiceBaseLib.PlatformProjectServ
 		}).future<void>()();
 	}
 
-	public buildProject(projectRoot: string, buildConfig?: IBuildConfig): IFuture<void> {
+	public buildProject(projectRoot: string, buildConfig?: IiOSBuildConfig): IFuture<void> {
 		return (() => {
 			let basicArgs = [
 				"-configuration", this.$options.release ? "Release" : "Debug",
@@ -204,6 +204,14 @@ export class IOSProjectService extends projectServiceBaseLib.PlatformProjectServ
 				]);
 			}
 
+			if (buildConfig && buildConfig.codeSignIdentity) {
+				args.push(`CODE_SIGN_IDENTITY=${buildConfig.codeSignIdentity}`);
+			}
+
+			if (buildConfig && buildConfig.mobileProvisionIdentifier) {
+				args.push(`PROVISIONING_PROFILE=${buildConfig.mobileProvisionIdentifier}`);
+			}
+
 			this.$childProcess.spawnFromEvent("xcodebuild", args, "exit", {cwd: this.$options, stdio: 'inherit'}).wait();
 
 			if (buildForDevice) {