nativescript-cloud
Advanced tools
Used for cloud support in NativeScript CLI
This section describes all methods that can be invoked when you have installed the nativescript-cloud extension and NativeScript CLI is required as library. You must load the installed extensions by calling loadExtensions method. After that you will be able to call methods from nativescript-cloud extension:
const tns = require("nativescript");
Promise.all(tns.extensibilityService.loadExtensions())
.then(loadedExtensionsData => {
// Write your code here, after all extensions are loaded.
});
NOTE: The extension must be installed before using it. You can do it by calling installExtension method of the CLI:
tns.extensibilityService.installExtension("nativescript-cloud@latest")
.then(extensionData => console.log(`Successfully installed extension ${extensionData.extensionName}.`))
.catch(err => console.log("Failed to install extension."));
The nsCloudBuildService allows build of applications in the cloud. You can call the following methods:
build method validates passed arguments and tries to build the application in the cloud. In case of successful build, the build result (.apk, .ipa or .zip) is downloaded. The result contains information about the whole build process, path to the downloaded build result and information used to generate a QR code, pointing to the latest build result (in S3).
Definition:
/**
* Builds the specified application in the cloud and returns information about the whole build process.
* @param {INSCloudProjectSettings} projectSettings Describes the current project - project dir, application identifier, name and nativescript data, as well as additional options to control the build workflow.
* @param {string} platform The mobile platform for which the application should be built: Android or iOS.
* @param {string} buildConfiguration The build configuration - Debug or Release.
* @param {string} accountId the account which will be charged for the build.
* @param {IAndroidBuildData} androidBuildData Android specific information for the build.
* @param {IIOSBuildData} iOSBuildData iOS specific information for the build.
* @returns {Promise<IBuildResultData>} Information about the build process. It is returned only on successful build. In case the build fails, the Promise is rejected with the server information.
*/
build(projectSettings: INSCloudProjectSettings,
platform: string,
buildConfiguration: string,
accountId: string,
androidBuildData?: IAndroidBuildData,
iOSBuildData?: IIOSBuildData): Promise<IBuildResultData>;
Detailed description of each parameter can be found here.
nsCloudBuildService raises the following events:
buildOutput event contains parts of the current build output:
interface IBuildLog {
cloudOperationId: string;
data: string;
pipe: string;
}
stepChanged event contains the name of the changed build step and its progress:
/**
* Describes build step.
*/
interface IBuildStep {
/**
* The ID of the cloud operation.
*/
cloudOperationId: string;
/**
* The name of the step - prepare, upload, build or download.
*/
step: string;
/**
* The progress of the step in percents. The value will be between 0 and 100.
*/
progress: number;
}
const tns = require("nativescript");
const fs = require("fs");
const path = require("path");
const packageJsonContent = JSON.parse(fs.readFileSync("./package.json", "utf8").toString());
const projectSettings = {
projectDir: process.cwd(),
projectId: packageJsonContent.nativescript.id,
projectName: path.dirname(process.cwd()),
nativeScriptData: packageJsonContent.nativescript,
bundle: true,
env: {
uglify: true
}
};
const androidReleaseConfigurationData = {
pathToCertificate: "./myCertificate.p12",
certificatePassword: "123456"
};
const platform = "android";
const buildConfiguration = "release";
tns.nsCloudBuildService.on("buildOutput", (data) => {
console.log(data);
/*
Sample data object:
{
"cloudOperationId": "2fb2e19c-3720-4fd1-9446-1df98f5e3531",
"pipe": "stdout",
"data": "Add platform ios with runtime version 2.5.*"
}
*/
});
tns.nsCloudBuildService.on("stepChanged", (data) => {
console.log(data);
/*
Sample data object:
{
"cloudOperationId": "2fb2e19c-3720-4fd1-9446-1df98f5e3531",
"step": "build";
"progress": 100;
}
*/
});
const accountId = "d0ce3ac0-36c2-427f-8d27-955915ffe189";
tns.nsCloudBuildService
.build(projectSettings, platform, buildConfiguration, accountId, androidReleaseConfigurationData)
.then(buildResult => console.log(buildResult))
.catch(err => console.error(err));
validateBuildProperties method validates all properties required for specific platform. This includes a check if current application identifier matches the CodeSigning identity for iOS operations, a check if the specified device identifier (in case it is passed) is included in the mobile provision, validation of the password, etc.
Definition:
/**
* Validates the build properties for specified platform (Android or iOS).
* The result promise is rejected with the error found. In case everything is correct, the promise is resolved.
* @param {string} platform The mobile platform for which the application should be built: Android or iOS.
* @param {string} buildConfiguration The build configuration - Debug or Release.
* @param {string} projectId Application identifier of the project.
* @param {IAndroidBuildData} androidBuildData Android speicific information for the build.
* @param {IIOSBuildData} iOSBuildData iOS speicific information for the build.
* @returns {Promise<void>}
*/
validateBuildProperties(platform: string,
buildConfiguration: string,
projectId: string,
androidBuildData?: IAndroidBuildData,
iOSBuildData?: IIOSBuildData): Promise<void>;
Detailed description of each parameter can be found here.
Usage:
const tns = require("nativescript");
const fs = require("fs");
const path = require("path");
const packageJsonContent = JSON.parse(fs.readFileSync("./package.json", "utf8").toString());
const projectId = packageJsonContent.nativescript.id;
const androidReleaseConfigurationData = {
pathToCertificate: "./myCertificate.p12",
certificatePassword: "123456"
};
const platform = "android";
const buildConfiguration = "release";
tns.nsCloudBuildService
.validateBuildProperties(platform, buildConfiguration, projectId, androidReleaseConfigurationData)
.then(buildResult => console.log("Data is valid"))
.catch(err => console.error("Data is invalid:", err));
getBuildOutputDirectory - Returns the path to the directory where the build output may be found.
This method is currently available only for backwards compatibility. The module now implements base module for server operations that exposes same functionality with more generic method:
getServerOperationOutputDirectory. Detailed description of the parameter can be found here.
Definition:
/**
* Returns the path to the directory where the build output may be found.
* @param {ICloudBuildOutputDirectoryOptions} options Options that are used to determine the build output directory.
* @returns {string} The build output directory.
*/
getBuildOutputDirectory(options: ICloudBuildOutputDirectoryOptions): string;
Detailed description of the parameter can be found here.
Usage:
const tns = require("nativescript");
const cloudBuildOutputDirectory = tns.nsCloudBuildService
.getBuildOutputDirectory({
platform: "ios",
projectDir: "/tmp/myProject"
emulator: false
});
The nsCloudCodesignService allows generation of codesign files (currently only iOS .p12 and .mobileprovision) in the cloud. You can call the following methods:
generateCodesignFiles method validates passed arguments and tries to generate codesign files in the cloud. In case of success, the result files (.p12 and/or .mobileprovision) are downloaded. The result contains information about errors, if any, and path to the downloaded codesign files (in S3).
Definition:
/**
* Generates codesign files in the cloud and returns s3 urls to certificate or/and provision.
* @param {ICodesignData} codesignData Apple speicific information.
* @param {string} projectDir The path of the project.
* @returns {Promise<ICodesignResultData>} Information about the generation process. It is returned only on successfull generation. In case there is some error, the Promise is rejected with the server information.
*/
generateCodesignFiles(codesignData: ICodesignData, projectDir: string): Promise<ICodesignResultData>;
Detailed description of the parameter can be found here.
Usage:
const tns = require("nativescript");
const codesignResultData = tns.nsCloudBuildService
.generateCodesignFiles({
username:'appleuser@mail.com',
password:'password',
platform: "ios",
clean: true,
attachedDevices: [{
displayName: 'iPhone',
identifier: 'cc3653b16f1beab6cf34a53af84c8a94cb2f0c9f'
}]
}, '/tmp/projects/myproj');
getServerOperationOutputDirectory method returns the path to the directory where the server request output files may be found, if any. In this implementation - the generated codesign files.
Definition:
/**
* Returns the path to the directory where the server request output may be found.
* @param {ICloudServerOutputDirectoryOptions} options Options that are used to determine the build output directory.
* @returns {string} The build output directory.
*/
getServerOperationOutputDirectory(options: ICloudServerOutputDirectoryOptions): string;
Detailed description of the parameter can be found here.
Usage:
const tns = require("nativescript");
const generateCodesignFilesOutputDirectory = tns.nsCloudBuildService
.getServerOperationOutputDirectory({
platform: "ios",
projectDir: "/tmp/myProject"
emulator: false
});
The nsCloudPublishService allows publishing build packages to an application store (either GooglePlay or iTunesConnect). You can call the following methods:
publishToItunesConnect method -will try to publish the provided package to iTunes Connect.
Definition:
/**
* Publishes the given .ipa packages to iTunes Connect.
* @param {IItunesConnectPublishData} publishData Data needed to publish to iTunes Connect.
* @returns {Promise<void>}
*/
publishToItunesConnect(publishData: IItunesConnectPublishData): Promise<void>;
Detailed description of the parameter can be found here.
Usage:
const tns = require("nativescript");
tns.nsCloudPublishService
.publishToItunesConnect({
credentials: {
username: "user",
password: "pass"
},
packagePaths: ["/tmp/myReleaseIpa.ipa"],
projectDir: "/tmp/myProject"
})
.then(() => {
console.log("Publishing succeeded");
})
.catch(err => console.error(err));
publishToGooglePlay method will try to publish the provided packages to Google Play.
Definition:
/**
* Publishes the given .apk packages to Google Play.
* @param {IGooglePlayPublishData} publishData Data needed to publish to Google Play.
* @returns {Promise<void>}
*/
publishToGooglePlay(publishData: IGooglePlayPublishData): Promise<void>;
Detailed description of the parameter can be found here.
Usage:
const tns = require("nativescript");
tns.nsCloudPublishService
.publishToGooglePlay({
track: "alpha",
pathToAuthJson: "/tmp/myAuthJson.json",
packagePaths: ["/tmp/myReleaseApk.apk"],
projectDir: "/tmp/myProject"
})
.then(() => {
console.log("Publishing succeeded");
})
.catch(err => console.error(err));
The nsCloudApplicationService allows for application management and gathering more information about the app's current state. You can call the following methods:
shouldBuild method will determine whether the current application should be built or not.
Definition:
/**
* Determines whether the application should be built or not.
* @param {IApplicationBuildConfig} config Settings used to help decide whether the project should be built or not.
* @returns {Promise<boolean>}
*/
shouldBuild(config: IApplicationBuildConfig): Promise<boolean>;
Detailed description of the parameter can be found here.
Usage:
const tns = require("nativescript");
tns.nsCloudApplicationService
.shouldBuild({
projectDir: "/tmp/myProject",
platform: "android",
outputPath: "/tmp/myProject/.cloud/android" // for cloud builds
})
.then((shouldBuild) => {
console.log("Should build? ", shouldBuild);
})
.catch(err => console.error(err));
shouldInstall method will determine whether the current application's package should be installed on the given device or not.
Definition:
/**
* Determines whether the application's output package should be installed on the given device or not.
* @param {IApplicationInstallConfig} config Settings used to help decide whether the project's output should be installed or not.
* @returns {Promise<boolean>}
*/
shouldInstall(config: IApplicationInstallConfig): Promise<boolean>;
Detailed description of the parameter can be found here.
Usage:
const tns = require("nativescript");
tns.nsCloudPublishService
.shouldInstall({
projectDir: "/tmp/myProject",
deviceIdentifier: "192.168.56.101:5555",
outputPath: "/tmp/myProject/.cloud/ios" // for cloud builds
})
.then((shouldInstall) => {
console.log("Should install?", shouldInstall);
})
.catch(err => console.error(err));
The nsCloudEmulatorLauncher provides a way for initial interaction with cloud emulators. You can call the following methods:
startEmulator method - starts an cloud emulator and returns a url where an html page is located, containing an iframe with the actual emulator. /**
* Describes options that can be passed when starting a cloud emulator.
*/
interface ICloudEmulatorStartData {
/**
* Path to the package file (.apk or .zip) to load - can either be a local path or a url.
*/
packageFile: string;
/**
* Platform for the emulator - android or ios
*/
platform: string;
/**
* Model of the emulator - for example nexus5, iphone5s, iphone6 - etc
*/
model: string;
}
/**
* Describes service for initial interaction with cloud emulators.
*/
interface ICloudEmulatorLauncher {
/**
* Starts a cloud emulator.
* @param {ICloudEmulatorStartData} data Options for starting emulator.
* @param optional {IConfigOptions} options The config options.
* @returns {string} A url containing an html page with the emulator inside an iframe. The url's host is localhost.
*/
startEmulator(data: ICloudEmulatorStartData): Promise<string>;
}
Usage:
const tns = require("nativescript");
tns.nsCloudEmulatorLauncher.startEmulator({
packageFile: "test.apk",
platform: "android",
model: "nexus5"
}).then(address => {
console.log("address is", address);
// http://localhost:56760/?publicKey=somekey&device=nexus5
});
The nsCloudAuthenticationService is used for authentication related operations (login, logout etc.). You can call the following methods
login mehod starts localhost server on which the login response will be returned. After that if there is options.openAction it will be used to open the login url. If this option is not defined the default opener will be used. After successful login returns the user information.
Definition:
/**
* Opens login page and after successfull login saves the user information.
* If options.openAction is provided, it will be used to open the login url instead of the default opener.
* @param {ILoginOptions} options Optional settings for the login method.
* @returns {Promise<IUser>} Returns the user information after successful login.
*/
login(options?: ILoginOptions): Promise<IUser>;
Detailed description of each parameter can be found here.
Usage:
const tns = require("nativescript");
tns.nsCloudAuthenticationService
.login()
.then(userInfo => console.log(userInfo))
.catch(err => console.error(err));
const tns = require("nativescript");
const childProcess = require("child_process");
const openAction = url => {
const isWin = /^win/.test(process.platform);
const openCommand = isWin ? "start" : "open";
childProcess.execSync(`${openCommand} ${url}`);
};
const loginOptions = { openAction: openAction };
tns.nsCloudAuthenticationService
.login(loginOptions)
.then(userInfo => console.log(userInfo))
.catch(err => console.error(err));
logout method invalidates the current user authentication data.
Definition:
/**
* Invalidates the current user authentication data.
* If options.openAction is provided, it will be used to open the logout url instead of the default opener.
* @param {IOpenActionOptions} options Optional settings for the logout method.
* @returns {void}
*/
logout(options?: IOpenActionOptions): void;
const tns = require("nativescript");
tns.nsCloudAuthenticationService.logout();
const tns = require("nativescript");
const childProcess = require("child_process");
const openAction = url => {
const isWin = /^win/.test(process.platform);
const openCommand = isWin ? "start" : "open";
childProcess.execSync(`${openCommand} ${url}`);
};
const logoutOptions = { openAction: openAction };
tns.nsCloudAuthenticationService.logout(logoutOptions);
isUserLoggedIn method checks if the access token of the current user is valid. If it is - the method will return true. If it isn't - the method will try to issue new access token. If the method can't issue new token it will return false.
Definition:
/**
* CheChecks if there is user info and the access token of the current user is valid. The method will try to issue new access token if the current is not valid.
* @returns {Promise<boolean>} Returns true if the user is logged in.
*/
isUserLoggedIn(): Promise<boolean>;
Usage:
const tns = require("nativescript");
tns.nsCloudAuthenticationService
.isUserLoggedIn()
.then(isLoggedIn => console.log(isLoggedIn))
.catch(err => console.error(err));
refreshCurrentUserToken method uses the refresh token of the current user to issue new access token.
Definition:
/**
* Uses the refresh token of the current user to issue new access token.
*/
refreshCurrentUserToken(): Promise<void>;
Usage:
const tns = require("nativescript");
tns.nsCloudAuthenticationService.refreshCurrentUserToken()
.then(() => console.log("Success"))
.catch(err => console.error(err));
cancelLogin method stops the current login process and rejects the login promise with an error.
Definition:
/**
* Stops the current login process and rejects the login promise with an error.
* @returns {void}
*/
cancelLogin(): void;
Usage:
const tns = require("nativescript");
tns.nsCloudAuthenticationService
.login()
.then(userInfo => console.log(userInfo))
.catch(err => console.error(err));
tns.nsCloudAuthenticationService.cancelLogin();
interface IUser {
email: string;
firstName: string;
lastName: string;
}
interface IAuthenticationService {
/**
* Uses username and password for login and after successfull login saves the user information.
* @param {string} username The username of the user.
* @param {string} password The password of the user.
* @returns {Promise<IUser>} Returns the user information after successful login.
*/
devLogin(username: string, password: string): Promise<IUser>;
/**
* Opens login page and after successfull login saves the user information.
* If options.openAction is provided, it will be used to open the login url instead of the default opener.
* @param {ILoginOptions} options Optional settings for the login method.
* @returns {Promise<IUser>} Returns the user information after successful login.
*/
login(options?: ILoginOptions): Promise<IUser>;
/**
* Invalidates the current user authentication data.
* If options.openAction is provided, it will be used to open the logout url instead of the default opener.
* @param {IOpenActionOptions} options Optional settings for the logout method.
* @returns {void}
*/
logout(options?: IOpenActionOptions): void;
/**
* Uses the refresh token of the current user to issue new access token.
*/
refreshCurrentUserToken(): Promise<void>;
/**
* Checks the token state of the current user.
* @returns {Promise<ITokenState>} Returns the token state
*/
getCurrentUserTokenState(): Promise<ITokenState>;
/**
* Stops the current login process and rejects the login promise with an error.
* @returns {void}
*/
cancelLogin(): void;
}
interface IOpenActionOptions {
/**
* Action which will receive url and decide how to open it.
*/
openAction?: (url: string) => void;
}
interface ILoginOptions extends IOpenActionOptions {
/**
* Sets the ammount of time which the login method will wait for login response in non-interactive terminal.
*/
timeout?: string;
}
interface ITokenState {
/**
* True if the access token is valid.
*/
isTokenValid: boolean;
/**
* The expiration timestamp. (1494.923982727)
*/
expirationTimestamp: number;
}
The nsCloudUserService is used to get information aboud the current user or modify it. You can call the following methods
hasUser method checks if there is user information.
Definition:
/**
* Checks if there is user information.
* @returns {boolean} Returns true if there is user information.
*/
hasUser(): boolean;
const tns = require("nativescript");
const hasUser = tns.nsCloudUserService.hasUser();
console.log(hasUser);
getUser method returns the current user information.
Definition:
/**
* Returns the current user information.
* @returns {IUser} The current user information.
*/
getUser(): IUser;
const tns = require("nativescript");
const user = tns.nsCloudUserService.getUser();
console.log(user);
Sample result for user will be:
{
"email": "some@mail.com",
"firstName": "First",
"lastName": "Last"
}
getUserData method returns the user information and the authentication data for the current user.
Definition:
/**
* Returns the user information and the authentication data for the current user.
* @returns {IUserData} The user information and the authentication data for the current user.
*/
getUserData(): IUserData;
Usage:
const tns = require("nativescript");
const userData = tns.nsCloudUserService.getUserData();
console.log(userData);
Sample result for userData will be:
{
"accessToken": "some token",
"refreshToken": "some refresh token",
"userInfo": {
"email": "some@mail.com",
"firstName": "First",
"lastName": "Last"
}
}
setUserData method sets the user information and the authentication data for the current user.
Definition:
/**
* Sets the user information and the authentication data for the current user.
* @param {IUserdata} userData The user data to set.
* @returns {void}
*/
setUserData(userData: IUserData): void;
Detailed description of each parameter can be found here.
Usage:
const tns = require("nativescript");
const userData = {
accessToken: "some token",
refreshToken: "some refresh token",
userInfo: {
email: "some@mail.bg",
firstName: "First",
lastName: "Last"
}
};
tns.nsCloudUserService.setUserData(userData);
setToken method sets only the token of the current user.
Definition:
/**
* Sets only the token of the current user.
* @param {ITokenData} token The token data.
* @returns void
*/
setToken(token: ITokenData): void;
Detailed description of each parameter can be found here.
Usage:
const tns = require("nativescript");
const token = {
accessToken: "some token"
};
tns.nsCloudUserService.setToken(token);
clearUserData method removes the current user data.
Definition:
/**
* Removes the current user data.
*/
clearUserData(): void;
Usage:
const tns = require("nativescript");
tns.nsCloudUserService.clearUserData();
getUserAvatar methods returns the URL where the avatar picture can be downloaded from.
Definition:
/**
* Return the URL where the avatar picture can be downloaded from.
* @returns {Promise<string>} Return the URL where the avatar picture can be downloaded from. It will return null if the user does not have avatar or it is not logged in.
*/
getUserAvatar(): Promise<string>;
const tns = require("nativescript");
tns.nsCloudUserService.getUserAvatar()
.then(userAvatar => console.log(userAvatar));
interface IUserService {
/**
* Checks if there is user information.
* @returns {boolean} Returns true if there is user information.
*/
hasUser(): boolean;
/**
* Returns the current user information.
* @returns {IUser} The current user information.
*/
getUser(): IUser;
/**
* Returns the user information and the authentication data for the current user.
* @returns {IUserData} The user information and the authentication data for the current user.
*/
getUserData(): IUserData;
/**
* Sets the user information and the authentication data for the current user.
* @param {IUserdata} userData The user data to set.
* @returns {void}
*/
setUserData(userData: IUserData): void;
/**
* Sets only the token of the current user.
* @param {ITokenData} token The token data.
* @returns void
*/
setToken(token: ITokenData): void;
/**
* Removes the current user data.
*/
clearUserData(): void;
/**
* Return the URL where the avatar picture can be downloaded from.
* @returns {Promise<string>} Return the URL where the avatar picture can be downloaded from. It will return null if the user does not have avatar or it is not logged in.
*/
getUserAvatar(): Promise<string>;
}
The nsCloudAccountsService provides methods for working with accounts. You can call the following methods:
getMyAccounts method returns the accounts which the current user can use. Each user will have personal account and shared accounts. Shared accounts are those accounts in which the user is added as developer.
Definition:
/**
* Returns all accounts which can be used from the current user.
* Each user can have personal account and shared accounts.
* @returns {Promise<IAccount[]>}
*/
getMyAccounts(): Promise<IAccount[]>
Detailed description of each parameter can be found here.
Usage:
const tns = require("nativescript");
tns.nsCloudAccountsService.getMyAccounts()
.then(accounts => console.log(accounts));
getUsageInfo method returns the usage information for the provided account.
Definition:
/**
* Returns the usage information for the provided account.
* @param {string} accountId Account id which will be used to get the usage info.
* @returns {Promise<IUsageInfo[]>}.
*/
getUsageInfo(accountId: string): Promise<IUsageInfo[]>;
Detailed description of each parameter can be found here.
Usage:
const tns = require("nativescript");
tns.nsCloudAccountsService.getUsageInfo("d0ce3ac0-36c2-427f-8d27-955915ffe189")
.then(usageInfo => console.log(usageInfo));
getAccountFeatures method returns information about all subscription features of the provided account.
Definition:
/**
* Returns information about all subscription features of the provided account.
* @param accountIdOption Account id which will be parsed and used to find account.
*/
getAccountFeatures(accountIdOption: string): Promise<IDictionary<IFeatureInfo>>;
Detailed description of each parameter can be found here.
Usage:
const tns = require("nativescript");
tns.nsCloudAccountsService.getAccountFeatures("d0ce3ac0-36c2-427f-8d27-955915ffe189")
.then(featuresInfo => console.log(featuresInfo));
nsCloudEulaService allows interaction with EULA - check if current EULA should be accepted, accepting it, etc.
getEulaData method gives information for the current EULA - url where to find it and if the user should accept it. When this method is called, it will download the latest EULA in case it has not been already downloaded in the current process. EULA must be accepted in the following condition:
In all other cases (current EULA is the same as the one user had accepted before, new EULA cannot be downloaded, but user had accepted EULA in the past), the method will return that EULA should not be accepted.
Definition:
/**
* Gives information about the EULA. This method downloads the EULA to a local file (once for process).
* @returns {Promise<IEulaData>} Information about the EULA - url and should the user accept it.
*/
getEulaData(): Promise<IEulaData>;
The returned result is of the following type:
/**
* Contains information about EULA.
*/
interface IEulaData {
/**
* URL where the EULA can be found.
*/
url: string;
/**
* Defines if EULA should be accepted by user.
*/
shouldAcceptEula: boolean;
}
Usage:
const tns = require("nativescript");
tns.nsCloudEulaService.getEulaData()
.then(eulaData => console.log(`EULA url is: ${eulaData.url}. This EULA should ${eulaData.shouldAcceptEula ? "" : "not" } be accepted.`));
getEulaDataWithCache method gives information for the current EULA - url where to find it and if the user should accept it. When this method is called, it will download the latest EULA ONLY in case it has not been downloaded in the latest 24 hours. That's the main difference between this method and getEulaData. EULA must be accepted in the following condition:
In all other cases (current EULA is the same as the one user had accepted before, new EULA cannot be downloaded, but user had accepted EULA in the past), the method will return that EULA should not be accepted.
Definition:
/**
* Gives information about the EULA. This method downloads the EULA to a local file (once for process)
* only in case the local copy has not been modified for more than 24 hours.
* @returns {Promise<IEulaData>} Information about the EULA - url and should the user accept it.
*/
getEulaDataWithCache(): Promise<IEulaData>;
The returned result has the same type as the one returned by getEulaData.
Usage:
const tns = require("nativescript");
tns.nsCloudEulaService.getEulaDataWithCache()
.then(eulaData => console.log(`EULA url is: ${eulaData.url}. This EULA should ${eulaData.shouldAcceptEula ? "" : "not" } be accepted.`));
acceptEula method downloads the latest EULA (in case it has not been downloaded in the current process), calculates its shasum and saves it in the user setings file. In case any of the operations fails, the acceptEula Promise will be rejected with the error.
Definition:
/**
* Accepts the EULA. The method first downloads the latest EULA (in case it has not been already downloaded in current process) and saves its shasum to user settings file.
* @returns {Promise<void>}
*/
acceptEula(): Promise<void>;
Usage:
const tns = require("nativescript");
tns.nsCloudEulaService.acceptEula()
.then(() => console.log(`Successfully accepted EULA.`))
.catch(err => console.error("Unable to accept EULA. Error is: ", err));
The nsCloudProjectService allows to manage cloud projects. You can call the following methods:
cleanupProject method cleans all cloud build data which is used for optimizations. The method will clean all AWS CodeCommit and build machine artefacts if they exist.
Definition:
/**
* Cleans all AWS CodeCommit data and build machines artefacts if they exist.
* @param {ICleanupProjectDataBase} cleanupProjectData Data needed for project cleaning.
* @returns {Promise<ICleanupProjectResult>} Information about the cleanup. It includes AWS CodeCommit result and the result from the cleanup on each build machine.
* If the promise is rejected the error will contain cloudOperationId property.
*/
cleanupProject(cleanupProjectData: ICleanupProjectDataBase): Promise<ICleanupProjectResult>;
Detailed description of each parameter can be found here.
Usage:
const tns = require("nativescript");
tns.nsCloudProjectService.cleanupProject({ appIdentifier: "org.nativescript.test", projectName: "test" })
.then((result) => console.log(`Cleanup result: ${result}`))
.catch(err => console.error("Unable to clean cloud project. Error is: ", err));
The nsCloudKinveyService allows working with Kinvey mBaaS. You can call the following methods:
getApps method returns information for all applications of the current user.
Definition:
/**
* Returns information for all applications of the current user.
* @returns {Promise<IKinveyApplication[]>}
*/
getApps(): Promise<IKinveyApplication[]>;
Detailed description of each parameter can be found here.
Usage:
const tns = require("nativescript");
tns.nsCloudKinveyService.getApps()
.then(result => console.log(`Apps: ${result}`))
.catch(err => console.error("Unable to get apps. Error is: ", err));
createApp method creates application in the account of the current user.
Definition:
/**
* Creates application in the account of the current user.
* @param input Input required to create application.
* @returns {Promise<IKinveyApplication>}
*/
createApp(input: ICreateKinveyAppInput): Promise<IKinveyApplication>;
Detailed description of each parameter can be found here.
Usage:
const tns = require("nativescript");
const createAppInput = {
name: "ns-cloud"
};
tns.nsCloudKinveyService.createApp(createAppInput)
.then(result => console.log(`Created app: ${result}`))
.catch(err => console.error("Unable to create app. Error is: ", err));
createAuthService method creates identity store. Then it creates authentication service in this identity store. Then it sets the default authentication service in the provided environment. Then it sets the default authentication service in the provided environment to the newly created service. Currently the supported providers are OAuth2, OIDC and SAML-Redirect.
Definition:
/**
* First this method creates identity store. Then it creates authentication service
* in this identity store. Then it sets the default authentication service in the provided environment
* to the newly created service.
* @param input Input required to create authentication service.
* @returns {Promise<IKinveyAuthService>}
*/
createAuthService(input: ICreateKinveyAuthService): Promise<IKinveyAuthService>;
Description of each parameter can be found here.
Detailed description of each parameter can be found here.
Usage:
const tns = require("nativescript");
// Create OAuth2 aithentication service.
const createOAuth2Options = {
name: "my-oauth2-service",
provider: {
type: "OAuth2",
remoteService: "https://test.com/oauth/token",
options: {
grantEndpoint: "https://test.com/authorize",
clientId: "<cleint-id>",
clientSecret: "<client-secret>",
userIdEndpoint: "https://test.com/userinfo",
scope: "<scope (e.g. openid)>"
}
}
};
const oauth2Input = {
appId: "<app-id>",
environmentId: "<env-id>",
redirectUri: ["https://auth.kinvey.com/oauth2/redirect", "http://example.com"],
authServiceOptions: createOAuth2Options
};
tns.nsCloudKinveyService.createAuthService(oauth2Input)
.then(result => console.log(`Created OAuth2 auth service: ${result}`))
.catch(err => console.error("Unable to create OAuth2 auth service. Error is: ", err));
// Create OIDC authentication service.
const createOIDCOptions = {
name: "my-oidc-service",
provider: {
type: "OIDC",
remoteService: "https://test.com/oauth/token",
options: {
grantEndpoint: "https://test.com/authorize",
clientId: "<client-id>",
clientSecret: "<client-secret>",
issuerId: "https://test.com",
scope: "<scope (e.g. profile)>"
}
}
};
const oidcInput = {
appId: "<app-id>",
environmentId: "<env-id>",
redirectUri: ["http://example.com"],
authServiceOptions: createOIDCOptions
};
tns.nsCloudKinveyService.createAuthService(oidcInput)
.then(result => console.log(`Created OIDC auth service: ${result}`))
.catch(err => console.error("Unable to create OIDC auth service. Error is: ", err));
// Create SAML-Redirect authentication service.
const createSAMLRedirectOptions = {
name: "my-auth-service",
provider: {
type: "SAML-Redirect",
remoteService: "https://test.com/samlp/<some-id>",
options: {
idpCertificate: "<certificate>"
}
}
};
const samlRedirectInput = {
appId: "<app-id>",
environmentId: "<env-id>",
redirectUri: ["http://example.com"],
authServiceOptions: createSAMLRedirectOptions
};
tns.nsCloudKinveyService.createAuthService(samlRedirectInput)
.then(result => console.log(`Created SAML-Redirect auth service: ${result}`))
.catch(err => console.error("Unable to create SAML-Redirect auth service. Error is: ", err));
updateAuthService method updates the provided authentication service.
Definition:
/**
* Updates the provided authentication service.
* @param input The id of the authentication service and full authentication service object.
* @returns {Promise<IKinveyAuthService>}
*/
updateAuthService(input: IUpdateKinveyAuthService): Promise<IKinveyAuthService>;
Description of each parameter can be found here.
Detailed description of each parameter can be found here.
Usage:
const tns = require("nativescript");
tns.nsCloudKinveyService.getDefaultAuthService({ environmentId: "<env-id>" })
.then(authService => {
const id = authService.id;
// The update auth service input can't contain the id parameter.
delete authService.id;
authService.name = "new-name";
const updateAuthServiceInput = {
authServiceId: id,
authService
};
return tns.nsCloudKinveyService.updateAuthService(updateAuthServiceInput);
})
.then(result => console.log(`Updated auth service: ${result}`))
.catch(err => console.error("Unable to update auth service. Error is: ", err));
getAuthServices method returns all authentication services which allow access to the provided environment.
Definition:
/**
* Returns all authentication services which allow access to the provided environment.
* The result is grouped by the identity store id.
* @param input The environment id.
* @returns {Promise<IDictionary<IKinveyAuthService[]>>}
*/
getAuthServices(input: IGetKinveyAuthServices): Promise<IDictionary<IKinveyAuthService[]>>;
Description of each parameter can be found here.
Detailed description of each parameter can be found here.
Usage:
const tns = require("nativescript");
tns.nsCloudKinveyService.getAuthServices({ environmentId: "<env-id>" })
.then(result => console.log(`Auth services: ${result}`))
.catch(err => console.error("Unable to get auth services. Error is: ", err));
getDefaultAuthService method returns the default authentication service for the provided environment.
Definition:
/**
* Returns the default authentication service for the provided environment.
* @param input The environment id.
* @returns {Promise<IKinveyAuthService>}
*/
getDefaultAuthService(input: IGetDefaultKinveyAuthService): Promise<IKinveyAuthService>;
Description of each parameter can be found here.
Detailed description of each parameter can be found here.
Usage:
const tns = require("nativescript");
tns.nsCloudKinveyService.getDefaultAuthService({ environmentId: "<env-id>" })
.then(result => console.log(`Default auth service: ${result}`))
.catch(err => console.error("Unable to get dafault auth service. Error is: ", err));
changeDefaultAuthService method changes the default authentication service in the provided environment.
Definition:
/**
* Changes the default authentication service in the provided environment.
* @param input Input required to change the default authentication service.
* @returns {Promise<IKinveyAuthService>}
*/
changeDefaultAuthService(input: IChangeDefaultKinveyAuthService): Promise<IKinveyAuthService>;
Description of each parameter can be found here.
Detailed description of each parameter can be found here.
Usage:
const tns = require("nativescript");
tns.nsCloudKinveyService.getAuthServices({ environmentId: "<env-id>" })
.then(authServices => {
const identityStoreId = Object.keys(authServices)[0];
const authServiceId = authServices[identityStoreId][0].id;
const changeDefaultAuthServiceInput = {
environmentId: "<env-id>",
authServiceId,
identityStoreId
};
return tns.nsCloudKinveyService.changeDefaultAuthService(changeDefaultAuthServiceInput);
})
.then(result => console.log(`New default auth service: ${result}`))
.catch(err => console.error("Unable to change dafault auth service. Error is: ", err));
The nsCloudConfigManager allows to manage cloud configuration. You can call the following methods:
reset resets the current cloud configuration to the default one - production.
Definition:
/**
* Resets config.json to it's default values.
* @returns {void}
*/
reset(): void;
Detailed description of each parameter can be found here.
Usage:
const tns = require("nativescript");
tns.nsCloudConfigManager.reset();
applyConfig applies specific configuration and saves it in config.json.
Definition:
/**
* Applies specific configuration and saves it in config.json
* @param {string} configName The name of the configuration to be applied.
* @param {IConfigOptions} [options] The config options.
* @param {IServerConfigBase} [globalServerConfig] The global server configuration which will
* be used when changing the configuration. This parameter will override the default global configuration.
* @returns {void}
*/
applyConfig(configName: string, options?: IConfigOptions, globalServerConfig?: IServerConfigBase): void;
Detailed description of each parameter can be found here.
Usage:
const tns = require("nativescript");
tns.nsCloudConfigManager.applyConfig("test");
getCurrentConfigData returns the current cloud configuration.
Definition:
/**
* Returns the current cloud configuration.
* @returns {IServerConfig}
*/
getCurrentConfigData(): IServerConfig;
Detailed description of each parameter can be found here.
Usage:
const tns = require("nativescript");
console.log(tns.nsCloudConfigManager.getCurrentConfigData());
getServiceDomainName returns the domain of the provided cloud service.
Definition:
/**
* Returns the domain of the provided cloud service.
* @param serviceName The name of the cloud service.
* @returns {string}
*/
getServiceDomainName(serviceName: string): string;
Detailed description of each parameter can be found here.
Usage:
const tns = require("nativescript");
console.log(tns.nsCloudConfigManager.getServiceDomainName("accounts-service"));
getCloudServicesDomainNames returns the domain names of all cloud services.
Definition:
/**
* Returns the domain names of all cloud services.
* @returns {string[]} The domain names of all cloud services.
*/
getCloudServicesDomainNames(): string[];
Detailed description of each parameter can be found here.
Usage:
const tns = require("nativescript");
console.log(tns.nsCloudConfigManager.getCloudServicesDomainNames());
getServiceValueOrDefault returns the value stored in the configuration of the provided service or the default value stored in the global configuration.
Definition:
/**
* Returns the value stored in the configuration of the provided service or the default value stored in the
* global configuration.
* @param serviceName The name of the cloud service.
* @param valueName The name of the value.
* @returns {string} The value specified in the provided service config or the value specified in the global config.
*/
getServiceValueOrDefault(serviceName: string, valueName: string): string;
Detailed description of each parameter can be found here.
Usage:
const tns = require("nativescript");
console.log(tns.nsCloudConfigManager.getServiceValueOrDefault("accounts-service", "serverProto"));
printConfigData prints the current cloud configuration on the stdout of the process.
Definition:
/**
* Prints the current cloud configuration on the stdout of the process.
* @returns {void}
*/
printConfigData(): void;
Detailed description of each parameter can be found here.
Usage:
const tns = require("nativescript");
tns.nsCloudConfigManager.printConfigData();
The project is written in TypeScript. After cloning it, you can set it up by executing the following commands in your terminal:
$ npm i --ignore-scripts - NOTE: --ignore-scripts is a must.$ npm i -g grunt-cli (only in case you do not have it installed globally)$ grunt test (first execution of this command might take a little bit longer, consecutive calls will work much faster)After that you can make changes in the code. In order to transpile them, just execute:
$ gruntYou can pack a new version of the library by executing:
$ grunt packFAQs
Used for cloud support in NativeScript CLI
The npm package nativescript-cloud receives a total of 7 weekly downloads. As such, nativescript-cloud popularity was classified as not popular.
We found that nativescript-cloud demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 9 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
A malicious npm package disguised as a WhatsApp client is exploiting authentication flows with a remote kill switch to exfiltrate data and destroy files.
Security News
PyPI now supports digital attestations, enhancing security and trust by allowing package maintainers to verify the authenticity of Python packages.
Security News
GitHub removed 27 malicious pull requests attempting to inject harmful code across multiple open source repositories, in another round of low-effort attacks.