Add a GitHub Repository
If your repository lives in GitHub, you can connect your repository automatically, or connect via SSH if you prefer.
If you prefer SSH, buddybuild will automatically generate a secure SSH key for you to install into your source control system. Buddybuild will use this key to clone your repository.
Important
|
Buddybuild has first-class integrations with the following repo providers: Buddybuild’s integrations provide the following features:
If you choose to use SSH to connect to your repo, buddybuild can only access your repository’s file content, and the features noted above do not work. |
Let’s get started!
Step 1: Enter the SSH Git Clone URL
Within the main page of your repository, look for the green Clone or Download button and click it to reveal a dropdown window. Click on Use SSH.
With SSH selected, copy the SSH URL by clicking the copy to clipboard button.
Head over to dashboard, visit Select source and choose SSH.
Paste the SSH URL you copied into the Git clone URL field.
Step 2: Add the SSH Key to Your GitHub Account
Highlight and copy the generated SSH key.
Navigate to your GitHub Account by first selecting your account photo, and then selecting Settings.
In the left navigation, select SSH keys.
Next, select Add SSH key.
Enter Buddybuild as the title, and paste the copied SSH key into the key field.
Next, click Add key.
Warning
|
Private git submodules and private cocoapods If your project depends on any code in other private git repos, the SSH key needs to be added to those repos as well. |
Navigate back to buddybuild and click on the Build button.
Buddybuild clones your project code and starts a simulator build. The build should finish within a few minutes.
That’s it! Your GitHub repository is now connected to buddybuild, and your first build is under way. The next steps are:
-
Add a GitHub webhook to automatically notify buddybuild of repository changes.
-
invite testers to try out your app.