Clone from Version Control

Filter by IDE
Select the AppBuilder client you are currently using for development.

IDE

When you need develop an app across the AppBuilder IDEs, you can quickly clone it from a Git repository. You can also clone an app from version control, when you need to recreate it or use it as a base for another app.

In the in-browser client, you can clone the contents of a remote repository over your current code and resources. This way, you can replace your current development work but preserve any data and additional settings for the app.

Prerequisites

  • Verify that third-party version control is configured for the app that you want to clone. For more information about AppBuilder and third-party version control, see Using Third-Party Version Control.
  • Verify that the master branch of the remote repository that you want to use contains the latest state of the app that you want to clone.
  • Verify that the app that you want to clone is developed with AppBuilder.
  • Verify that the root or the first-level directory of the remote repository contains the .abproject file for the app that you want to clone.

Procedure

In-Browser

Create New App

Complete the following steps to create a new app using the code and assets stored in a remote repository. This operation also connects your app to the remote repository.

  1. Verify that you are on the Telerik Platform home page.
    To return to the home page, click your account name in the breadcrumb in the top left corner.
  2. Select Apps.
  3. Click Create app.
  4. Click Advanced.
  5. Select Clone repository.
  6. Provide the clone URL for the repository that contains your app.
  7. Provide an app name.
  8. (Optional) Provide description.
  9. Click Create App and wait for the in-browser client to load the app.

A new app is added in your Telerik Platform account and all files are checked into the integrated AppBuilder version control. Third-party version control is configured and your app is connected to the repository from which you cloned it. Telerik Platform opens the code for your new app and lists all app files in the Project Navigator.

Replace Current Code and Resources

Complete the following steps to override the code and resources of an app with the contents of a remote repository. This way, you can preserve your data, other services and settings enabled for your app.

  1. Open the code of the app that you want to replace with the contents of a remote repository.
  2. Select Version ControlConfigure Remote Repository.
  3. Begin connecting your app to the remote repository that you want to use. For more information, see the following resources:
  4. If you have decided to use the quick connect option, complete the following steps:

    1. Select Connect to any Git provider and enter the clone URL for the repository.
    2. Select the Replace this app with the contents of the remote repository check box.
    3. Click Connect.
    4. Confirm the operation.
    5. If prompted, provide your login credentials for the repository, choose whether you want the in-browser client to remember your credentials and click Ok.
      If you choose to preserve your login credentials, the in-browser client stores them for the current browser session only.

      Two-factor authentication: If you have enabled two-factor authentication for GitHub, you need to provide a personal access token instead of password.

  5. If you have decided to connect to GitHub, complete the following steps:

    1. Select Connect to GitHub and click Next.
    2. Provide your login credentials for GitHub, choose whether you want the in-browser client to remember your credentials and click Ok.
      If you choose to preserve your login credentials, the in-browser client stores them for the current browser session only.

      Two-factor authentication: If you have enabled two-factor authentication for GitHub, you need to provide a personal access token instead of password.

    3. Select the repository to which you want to connect and click Connect.
    4. Select the Replace this app with the contents of the remote repository check box.
    5. Click Done.
    6. Confirm the operation.

The in-browser client reloads your app.

Universal

  1. Run the universal desktop client.
  2. Click Create App.
  3. Click Advanced.
  4. Select Clone repository.
  5. Provide the clone URL for the repository that contains your app.
  6. Provide an app name.
  7. (Optional) Provide description.
  8. Click Create App and wait for the universal desktop client to load the app.

A new app is added in your Telerik Platform account and all files are checked into the integrated AppBuilder version control. Third-party version control is configured and your app is connected to the repository from which you cloned it. Telerik Platform opens the code for your new app and lists all app files in the Project Navigator.

Windows

  1. Run the classic Windows desktop client.
  2. From the Dashboard, click New and select Advanced.
  3. Select Clone Repository.
  4. Provide the clone URL for the repository that contains your app.
  5. Provide an app name.
  6. Click Clone.

A new app is added in your Telerik Platform account and all files are checked into the integrated AppBuilder version control. Third-party version control is configured and your app is connected to the repository from which you cloned it. Telerik Platform opens the code for your new app and lists all app files in the Project Navigator.

Visual Studio

  1. On your local file system, clone the remote repository that contains the app.
  2. Run the extension for Visual Studio.
  3. In the top menu bar, click FileOpenProject/Solution.
  4. Navigate to the location where your app is stored.
  5. Locate the .abproject file for your app and double-click it.
  6. If prompted, log in.

CLI

  1. On your local file system, clone the remote repository that contains the app.
  2. In the command prompt, navigate to the directory that contains the .abproject file for your app.

Next Steps

Continue development.

See Also

Start a free trial Request a demo
Contact us: +1-888-365-2779
sales@telerik.com
Copyright © 2016-2017, Progress Software Corporation and/or its subsidiaries or affiliates. All rights reserved.