{{indexmenu_n>10}}


====== VIM4 Download Android Source Code ======

===== Introduction =====

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

===== Download from github =====
<tabbox Android 14>
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-vim4-android14
```

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

```shell
$ repo sync -c -j4
```
The initial sync operation may take an hour or more to complete.

<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
repo sync -c -j4
while [ $? = 1 ]; do
	echo "Sync failed, repeat again:"
	repo sync -c -j4
done
```

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

</WRAP>

4. Begin a new branch for development:

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

<tabbox Android 11>
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-vim4-r-64bit
```

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

```shell
$ repo sync -c -j4
```
The initial sync operation may take an hour or more to complete.

<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
repo sync -c -j4
while [ $? = 1 ]; do
	echo "Sync failed, repeat again:"
	repo sync -c -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
```

===== Download from cloud drive =====
Chinese developers can download base package from cloud drive. Then synchronize the code.\\

1. Download the android source code base package from follow links.\\

 * [[https://pan.baidu.com/s/16iFJVCLqIX00YJo6XXJ-YA?pwd=b7wk|VIM4 android11 source code base package]]\\

2. Use the following command to unzip the base package and synchronize the code.
```shell
$ cat vim4-android11-20240811.tar.gza* | tar -xzv
$ .repo/repo/repo sync -l
$ .repo/repo/repo forall -c 'git lfs pull'
```
</tabbox>
===== Further Reading =====

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