akadmin c5e7c48779 chore: initial project setup

- Add Dockerfile for build environment
- Add docker-compose.yml for container orchestration
- Add docker-entrypoint.sh for build process automation
- Add .env for environment configuration
- Add .gitignore for ignoring build artifacts and temporary files
- Add README.md with build instructions
- Add LICENSE (Apache 2.0)

2025-09-29 09:45:42 +03:00

3.1 KiB

Raw Blame History

How to Build IodeOs with Docker

Why Docker?

Using Docker ensures all required dependencies are pre-installed and properly configured.
You don’t need to install complex toolchains or modify your host system.

Requirements

Software

Docker
Install Docker using the official script:
```
curl -fsSL https://get.docker.com | sh
```
Git Install Git

Repo tool Install the Google repo tool:

mkdir -p ~/bin
curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
chmod a+x ~/bin/repo
export PATH=~/bin:$PATH

Hardware

Disk: SSD recommended
- Total required: ~638 GB
  - ~394 GB source code
  - ~244 GB build artifacts
CPU: 64-bit processor (Intel i5/i7 or AMD Ryzen 5/7 and above recommended, 8 cores or more preferred)
Memory:
- Minimum: 16 GB RAM
- Bare minimum: 8 GB RAM (with swap; builds will be very slow and unstable)

Usage

Clone this repo to your local machine and navigate into it:

git clone https://git.os-source.co/IodeOs/build.git
cd build

Initialize and sync the repo into the IodeOs/build checkout directory:

repo init -u https://git.os-source.co/IodeOs/manifests_android -b v6-staging

Sync the repo (this may take a while):
```
repo sync
```
💡 Tip: You can speed up and stabilize the sync process with additional options:
```
repo sync -c -j$(nproc --all) --force-sync --no-clone-bundle --no-tags -f
```
- -c : Sync only the current manifest branch
- -j$(nproc --all) : Use all available CPU cores for parallel sync
- --force-sync : Discard local changes and ensure a clean state
- --no-clone-bundle : Skip using potentially outdated pre-packaged bundles
- --no-tags : Avoid downloading all Git tags (saves time/space)
- -f : Continue syncing other projects even if one fails
Start the build with Docker:
```
docker compose up -d
```
Check the build logs and wait:
```
docker logs -f repo_build_iode
```
Once the "success message" appears in the logs (this typically takes 90–240 minutes, depending on your hardware and the number of threads used), navigate to the out folder to find your OTA package or fastboot images.

Troubleshooting

Repo tool not found

If you see:

command not found: repo

Make sure ~/bin is in your PATH:

export PATH=~/bin:$PATH

Add it to your ~/.bashrc or ~/.zshrc to make the change permanent.

Repo sync is very slow or stalls

Use more jobs with -j<number> (e.g. repo sync -j16) if you have a fast CPU and good network.

If syncing fails, retry with:

repo sync --force-sync --no-clone-bundle --no-tags

Licensing

IodeOs/build is licensed under the Apache License, Version 2.0. See LICENSE for the full license text.

3.1 KiB Raw Blame History Unescape Escape