{{indexmenu_n>10}}



====== VIM1S Download Android Source Code ======

===== Introduction =====

This document mainly introduces how to download the Android source code of VIM1S.

===== Get Source Code =====

Install git-lfs tool to download Android 11.0 SDK

```shell
$ sudo apt install git-lfs
```

1. Create an empty directory to store working files

```shell
$ mkdir -p WORKING_DIRECTORY
$ cd WORKING_DIRECTORY
```

2. Run ''repo init'' to download the manifest repository first

```shell
$ repo init -u https://github.com/khadas/android_manifest.git -b khadas-vim1s-r
```

3. Run ''repo sync'' to pull down the Android Source branch

```shell
$ repo sync -j4
```
It will take approx one hour to complete the initial sync operation.


<WRAP info >
You might need to run above command repeatly if it fails halfway. Or you can try with this script instead:
```bash sync_helper.sh
#!/bin/bash
repo sync -j4
while [ $? = 1 ]; do
	echo "Sync failed, repeat again:"
	repo sync -j4
done
```

If needed, press ''Ctrl''+''C'' to quit.

</WRAP>

4. Run the following command to pull large files. Otherwise, compilation will report an [[https://forum.khadas.com/t/cannot-build-an-android/15886|error]].

```shell
$ repo forall -c 'git lfs pull'
```

5. Begin a new branch for development

```shell
$ repo start <BRANCH_NAME> --all
```

===== Further Reading =====

  * [[https://source.android.com/source/downloading.html|Android Official Documents]]
  * [[products:sbc:vim1s:development:android:build-android|Build Android]]