Enabling Hyperloop

Introduction

Each Titanium project that want to use Hyperloop requires the Hyperloop-services to be enabled. By default, Hyperloop is disabled and you can enable it for your projects via the CLI or within Studio.

Requirements

  • Studio: 4.7.0+
  • SDK: 5.4.0+
  • CLI: 5.4.0+

 

Please note: 

  • If you attempt to create an app that is called "Hyperloop" (the app-name in the tiapp.xml) you may experience failures in the build process, because it is a reserved word. Please use a different project name for this case.
  • Hyperloop expects Xcode to be in /Applications/Xcode.app to reference system-libraries, so please ensure that Xcode is located at the this location.

Enabling via CLI

When creating a new project, the CLI will check if you are entitled to use Hyperloop. If the you are, the CLI will prompt you with the following message: "Would you like to enable Hyperloop for this app (This may take a while...)". If you enable Hyperloop, it will take some time to retrieve the module and set up your project.

Note: If you have any issue enabling Hyperloop from the CLI, OR you are not asked if you want to enable Hyperloop, ensure you are logged into the platform with the appropriate subscription, use appc login to confirm you are logged in.

Enabling via Studio

Creating new Hyperloop-enabled project

With Appcelerator Studio open and logged in, follow these steps to create a new Hyperloop-enabled project:

  1. Open New Mobile App Project wizard.
     
  2. Under AMPLIFY Appcelerator Services section, you will see Hyperloop listed along with Cloud, Test, Performance, and Analytics (if you are entitled to use it). Check the Enable AMPLIFY Appcelerator Services toggle.
  3. Click Finish.
  4. During the project creation, Studio will prompt you with a confirmation to enable Hyperloop. The prompt should say something like this: "Would you like to enable Hyperloop for this app (This may take a while...)". Click Yes to confirm.

To confirm that Hyperloop was set up, you can open the tiapp.xml file in the Service section.

After enabling Hyperloop, the following tags should have been added to the tiapp.xml file, you can validate them here:

<plugins>
     <plugin>hyperloop</plugin>
</plugins> 
 <modules>
     <module platform="android">hyperloop</module>
     <module platform="iphone">hyperloop</module>
</modules>

Enabling Hyperloop on non-Hyperloop projects

If Hyperloop was disabled or not available when the project was created, you can enable Hyperloop from the tiapp.xml editor service section by clicking on Enable Services and selecting Hyperloop.

 

Related Links