Skip to Content

Create a Directory for Development

0 %
Create a Directory for Development

Create a Directory for Development

August 18, 2021
Created by
June 14, 2021
This tutorial shows you how to start building your application with CAP and VS Code.

You will learn

  • How to develop the app
  • How to download the complete tutorial
  • How to create a GitHub repository
  • How to clone your GitHub repository
QR code

Step 1: Develop the app

If a tutorial has prerequisites, they’re listed at the beginning of the tutorial.

For the tutorial, you need a directory to develop the app and you need access to the template files. We recommend choosing one root directory (that is the tutorial root directory) for both the directory for your app (cpapp) and the tutorial directory (tutorial) with the template files. See the table below:

Directory Contents
tutorial root directory the directory containing cpapp and tutorial
tutorial the directory containing the clone of the tutorial repository
tutorial/templates templates provided by the tutorial repository
cpapp the directory that will contain your application
Log on to answer question

Step 2: Download the tutorial

Downloading the tutorial gives you easy access to template files that are required for some tutorials.

  1. Open a terminal.

  2. Navigate to the previously decided tutorial root directory.

    cd <tutorial root directory>
  3. Clone the tutorial.

    git clone tutorial
Log on to answer question

Step 3: Create a GitHub repository for your project

To be able to perform the steps for CI/CD, you will need a public repository. Currently, SAP Continuous Integration and Delivery supports GitHub and Bitbucket repositories.

We recommend creating a public GitHub repository to save your tutorial application because this is what the tutorial uses. This way, if you have issues with your tutorial application, you can refer to it.

For real application development, you need to consider the right place for your repository, of course.

Go to GitHub and create a new GitHub repository.

Info about branches

For the sake of simplicity, don’t create additional branches in your repository. When initially created, your repository has only one branch - the main branch. This is the only branch you need to complete the tutorial.

Log on to answer question

Step 4: Clone your GitHub repository
  1. Copy the repository’s URL you have created before.

  2. Open a terminal.

  3. Navigate to the tutorial root directory.

    cd <tutorial root directory>
  4. Clone your new repository.

    git clone <git-repository-url> cpapp

    Replace <git-repository-url> with your GitHub repository’s URL.

Log on to answer question

Step 5: Copy the files to start from an example

To earn your badge for the whole mission, you will need to mark all steps in a tutorial as done, including any optional ones that you may have skipped because they are not relevant for you.

If you don’t want to start from scratch, but from a specific example of the tutorial, you can copy the required files in your project. Alternatively, you can fork the project and work on the fork.

The name of the prerequisite branch is given on the top of each tutorial that requires code changes.

  1. Look-up the branch in the tutorial.

  2. Open a terminal.

  3. Navigate to the tutorial root directory.

    cd <tutorial root directory>
  4. Check out the example’s branch.

    cd tutorial
    git checkout <branch>

    Replace <branch> with the name of the branch of the example that you want to start with.

  5. Copy all files from the example to a local directory <project-dir>, except the .git directory.

    cp -r .gitignore $(ls -1A | grep -v .git) ../cpapp
  6. Check out the master branch to get access to the template files again.

    git checkout master
  7. Switch to your app directory.

    cd ../cpapp
  8. Install required Node.js modules in your app directory.

    npm install
What are the contents of your "tutorial root directory"?

Give us 55 seconds of your time to help us improve

Next Steps

Back to top