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,9 @@ $injector.requireCommand("test|ios", "./commands/test");
 $injector.requireCommand("test|init", "./commands/test-init");
 $injector.requireCommand("dev-generate-help", "./commands/generate-help");
 
+$injector.requireCommand("publish|ios", "./commands/publish-ios");
+$injector.require("itmsTransporterService", "./services/itmstransporter-service");
+
 $injector.require("npm", "./node-package-manager");
 $injector.require("npmInstallationManager", "./npm-installation-manager");
 $injector.require("lockfile", "./lockfile");

lib/commands/publish-ios.ts

@@ -0,0 +1,46 @@
+///<reference path="../.d.ts"/>
+"use strict";
+
+import {StringCommandParameter} from "../common/command-params";
+
+export class PublishIOS implements ICommand {
+	constructor(private $injector: IInjector,
+		private $itmsTransporterService: IITMSTransporterService,
+		private $logger: ILogger,
+		private $options: IOptions,
+		private $prompter: IPrompter,
+		private $stringParameterBuilder: IStringParameterBuilder) { }
+
+	public allowedParameters: ICommandParameter[] = [this.$stringParameterBuilder.createMandatoryParameter("Missing required Apple ID parameter."),
+		new StringCommandParameter(this.$injector), new StringCommandParameter(this.$injector), new StringCommandParameter(this.$injector), new StringCommandParameter(this.$injector)];
+
+	public execute(args: string[]): IFuture<void> {
+		return (() => {
+			let app_id = args[0],
+				userName = args[1],
+				password = args[2],
+				mobileProvisionIdentifier = args[3],
+				codeSignIdentity = args[4];
+
+			if(!userName) {
+				userName = this.$prompter.getString("Apple ID", { allowEmpty: false }).wait();
+			}
+
+			if(!password) {
+				password = this.$prompter.getPassword("Apple ID password").wait();
+			}
+
+			if(!mobileProvisionIdentifier) {
+				this.$logger.warn("Mobile Provision identifier not set - a default one will be used. You can set one in App_Resources/iOS/build.xcconfig");
+			}
+
+			if(!codeSignIdentity) {
+				this.$logger.warn("Code Sign Identity not set - a default one will be used. You can set one in App_Resources/iOS/build.xcconfig");
+			}
+
+			this.$options.release = true;
+			this.$itmsTransporterService.upload(app_id, userName, password, mobileProvisionIdentifier, codeSignIdentity).wait();
+		}).future<void>()();
+	}
+}
+$injector.registerCommand("publish|ios", PublishIOS);

lib/common

@@ -89,6 +89,23 @@ interface IInitService {
 	initialize(): IFuture<void>;
 }
 
+/**
+ * Used for communicating with Xcode's iTMS Transporter tool.
+ */
+interface IITMSTransporterService {
+	/**
+	 * Builds and uploads an .ipa package to itunesconnect.
+	 * Note that if mobileProvisionIdentifier and/or codeSignIdentity are passed to this method they will override any options set through .xcconfig files.
+	 * @param  {string} appId	The application's Apple ID. It can be found on itunesconnect.apple.com.
+	 * @param  {string} username	Username for authentication with itunesconnect.
+	 * @param  {string} password	Password for authentication with itunesconnect.
+	 * @param  {string} mobileProvisionIdentifier?	The identifier of the mobile provision used for building.
+	 * @param  {string} codeSignIdentity?	The Code Sign Identity used for building.
+	 * @returns IFuture<void>
+	 */
+	upload(appId: string, username: string, password: string, mobileProvisionIdentifier?: string, codeSignIdentity?: string): IFuture<void>;
+}
+
 /**
  * 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

@@ -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) {

lib/services/ios-project-service.ts

@@ -0,0 +1,88 @@
+///<reference path="../.d.ts"/>
+"use strict";
+import * as path from "path";
+import * as temp from "temp";
+let md5 = require("cryptojs").Crypto.MD5;
+
+export class ITMSTransporterService implements IITMSTransporterService {
+	private _itmsTransporterPath: string = null;
+
+	constructor(private $childProcess: IChildProcess,
+		private $devicePlatformsConstants: Mobile.IDevicePlatformsConstants,
+		private $errors: IErrors,
+		private $fs: IFileSystem,
+		private $platformService: IPlatformService,
+		private $staticConfig: IStaticConfig,
+		private $sysInfo: ISysInfo) { }
+
+	public upload(appId: string, username: string, password: string, mobileProvisionIdentifier?: string, codeSignIdentity?: string): IFuture<void> {
+		return (() => {
+			temp.track();
+			let itmsTransporterPath = this.getITMSTransporterPath().wait(),
+				ipaFileName = "app.ipa",
+				itmsDirectory = temp.mkdirSync("itms-"),
+				innerDirectory = path.join(itmsDirectory, "mybundle.itmsp"),
+				ipaFileLocation = path.join(innerDirectory, ipaFileName),
+				platform = this.$devicePlatformsConstants.iOS,
+				forDevice = true,
+				iosBuildConfig: IiOSBuildConfig = {
+					buildForDevice: forDevice,
+					mobileProvisionIdentifier: mobileProvisionIdentifier,
+					codeSignIdentity: codeSignIdentity
+				};
+
+			this.$fs.createDirectory(innerDirectory).wait();
+
+			this.$platformService.preparePlatform(platform).wait();
+			this.$platformService.buildPlatform(platform, iosBuildConfig).wait();
+			this.$platformService.copyLastOutput(platform, ipaFileLocation, { isForDevice: forDevice }).wait();
+
+			let ipaFileHash = md5(this.$fs.readFile(ipaFileLocation).wait()),
+				ipaFileSize = this.$fs.getFileSize(ipaFileLocation).wait(),
+				metadata = `<?xml version="1.0" encoding="UTF-8"?>
+<package version="software4.7" xmlns="http://apple.com/itunes/importer">
+    <software_assets apple_id="${appId}">
+        <asset type="bundle">
+            <data_file>
+                <file_name>${ipaFileName}</file_name>
+                <checksum type="md5">${ipaFileHash}</checksum>
+                <size>${ipaFileSize}</size>
+            </data_file>
+        </asset>
+    </software_assets>
+</package>`;
+
+			this.$fs.writeFile(path.join(innerDirectory, "metadata.xml"), metadata).wait();
+
+			this.$childProcess.spawnFromEvent(itmsTransporterPath, ["-m", "upload", "-f", itmsDirectory, "-u", username, "-p", password, "-v", "informational"], "close", { stdio: "inherit" }).wait();
+		}).future<void>()();
+	}
+
+	private getITMSTransporterPath(): IFuture<string> {
+		return (() => {
+			if (!this._itmsTransporterPath) {
+				let sysInfo = this.$sysInfo.getSysInfo(path.join(__dirname, "..", "..", this.$staticConfig.PROJECT_FILE_NAME)).wait(),
+					xcodeVersionMatch = sysInfo.xcodeVer.match(/Xcode (.*)/),
+					result = path.join("/Applications", "Xcode.app", "Contents", "Applications", "Application Loader.app", "Contents");
+
+				if (xcodeVersionMatch && xcodeVersionMatch[1]) {
+					let [major, minor] = xcodeVersionMatch[1].split(".");
+					// iTMS Transporter's path has been modified in Xcode 6.3
+					// https://github.com/nomad/shenzhen/issues/243
+					if (+major <= 6 && +minor < 3) {
+						result = path.join(result, "MacOS");
+					}
+				}
+
+				this._itmsTransporterPath = path.join(result, "itms", "bin", "iTMSTransporter");
+			}
+
+			if(!this.$fs.exists(this._itmsTransporterPath).wait()) {
+				this.$errors.failWithoutHelp('iTMS Transporter not found on this machine - make sure your Xcode installation is not damaged.');
+			}
+
+			return this._itmsTransporterPath;
+		}).future<string>()();
+	}
+}
+$injector.register("itmsTransporterService", ITMSTransporterService);

lib/services/itmstransporter-service.ts

@@ -35,6 +35,7 @@
     "cli-table": "https://github.com/telerik/cli-table/tarball/v0.3.1.1",
     "clui": "0.3.1",
     "colors": "1.1.2",
+    "cryptojs": "2.5.3",
     "esprima": "2.7.0",
     "ffi": "https://github.com/icenium/node-ffi/tarball/v2.0.0.1",
     "fibers": "https://github.com/icenium/node-fibers/tarball/v1.0.6.3",