VoltBuilder

From NSB App Studio
Jump to navigation Jump to search

VoltBuilder is a service which takes the files from a web app (such as those produced by AppStudio) and turns them into a native Android and iOS app.

To use it from AppStudio, you will need a VoltBuilder Plan. Use of it is included in your AppStudio subscription. More information here.

How to set up VoltBuilder in AppStudio

Put your certificates in the Certificates folder (in your Project Directory) In Project Properties, in the VoltBuilder and Cordova section, fill in the following properties:

Property Description
Properties to build for Android.
androidAlias Name of the alias in the android keystore file. Must be in certificates folder. Release only.
androidAliasPassword Password for alias in the Android keystore file. Release only.
androidKeystore A .keystore file, generated by this procedure. Required for release builds. Must be in certificates folder. You can generate it using VoltSigner. Release only.
androidKeystorePassword Password. Release only.
androidPackageType Normally apk. For Google Play Store, set to 'bundle' to get an .aab file and set release to "release".
androidSigningVersion Normally 2 for Google Play Store. Other platforms may require other values.
googlePlayKey This is the name of the keyfile which will let VoltBuilder submit to Google, without allowing VoltBuilder to see any secure information. Go to Upload to Google Play for instructions on getting your key. (.json).
googlePlayTrack This is the Google Play Store track.
Properties required to build for iOS
appStoreAccount Your Apple ID.
appStoreAppPassword This is an app specific password which will let VoltBuilder submit to Apple, without allowing VoltBuilder to see any secure information. Go to the Apple ID page and sign in. In the Security section, click on 'Generate Password...' Use VoltBuilder as your password label. You'll get back a string like wxyz-ymul-hbqn-xxxx which you paste here.
iosDevP12 The p12 file is generated from the development certificate downloaded from Apple. See Submitting to the iOS App Store. You can use the same p12 for multiple apps. Leave blank if you are not building for iOS. Must be in certificates folder. You can generate it using VoltSigner.
iosDevP12Password The password specified when exporting the .p12 file. Leave blank if you are not building for iOS.
iosDevelopment The mobileprovision file is downloaded from Apple. It specifies which devices the app is allowed to run on. You need a separate mobileprovision file for each one of your apps. Leave blank if you are not building for iOS. Must be in certificates folder. You can generate it using VoltSigner.
iosDistP12 The p12 file is generated from the distribution certificate downloaded from Apple. See Submitting to the iOS App Store. Leave blank if you are not building for iOS Distribution. Must be in certificates folder. You can generate it using VoltSigner.
iosDistP12Password The password specified when exporting the .p12 file. Leave blank if you are not building for iOS Distribution.
iosDistribution The mobileprovision file is downloaded from Apple. It specifies which devices the app is allowed to run on. You need a separate mobileprovision file for each one of your apps. Leave blank if you are not building for iOS Distribution. Must be in certificates folder. You can generate it using VoltSigner.
iosPackageType This field has the following settings:
  • enterprise: Build for Enterprise Distribution. This is for apps which are used within an Enterprise only.
  • ad-hoc: Make an ad-hoc build. This will run on your local devices.
  • app-store: Make a build suitable for uploading to the iTunes Store.
Other Properties
BuildCounter Counts the number of builds so each build has a unique versionCode
config.xml Configuration data. See the docs.
icon (1024) Icon template. Must be 1024x1024 png, jpg or jpeg. If not supplied, AppStudio icon will be used.
platform What platform do you want to build for? Android, iOS or Windows.
release What kind of build is this? debug or release.
splash (2732) Splash screen template. Must be 2732x2732 png, jpg or jpeg. If not supplied, AppStudio splash screen will be used. File should be dragged into the top level of the Project Explorer.
splash background Background Color of splash background (Android) as #RRGGBB
statusbarColor Background Color of statusbar as #RRGGBB. Can not be blank.
statusbarOverlay Should the statusbar overlay the app?
statusbarStyle Style: default, lightcontent, blacktranslucent, blackopaque
verbose Controls the amount of debugging in the log.

How to run VoltBuilder from AppStudio

Use 'Make Native App with VoltBuilder' in the run menu. In about a minute (depending on the size of your app and the server load), you will get a link to download your app.