components/cronet/ios/docs/BUILD.md

# Building Cronet (on iOS)

## Get source and dependencies
### source
- Install depot_tools per https://chromium.googlesource.com/chromium/src/+/main/docs/ios/build_instructions.md
- Make directory for the chromium source, and then fetch:
```
    ~ $ mkdir chromium && cd chromium
    ~/chromium $ fetch --nohooks ios
```

- Enter the ./src directory:
```
    ~/chromium $ cd src
```
### deps
- Download the depenedencies
```
    ~/chromium/src $ gclient sync
```

## Build it!

- We'll be using it a bunch, so you may want to put cr_cronet.py in your path.  Of course, you can just use its full name every time if you want...
```
    ~/chromium/src $ ln -s /path/to/components/cronet/tools/cr_cronet.py /somewhere/in/your/path
```

    or however else you want to do this

This sets up the build directory...
```
    ~/chromium/src $ cr_cronet.py gn
```
...and this builds it!
```
    ~/chromium/src $ cr_cronet.py build -d out/Debug-iphonesimulator
```

- You can also use build-test to run tests on the simulator
```
    ~/chromium/src $ cr_cronet.py build-test -d out/Debug-iphonesimulator
```

- If you want to deploy to hardware, you will have to set up XCode for deploying to hardware, and then use cr_cronet.py gn with the -i flag (for iphoneos build), and cr_cronet.py build with either the -i flag, or using the out/Debug-iphoneos directory.
```
    ~/chromium/src $ cr_cronet.py gn -i
```
and then
```
    ~/chromium/src $ cr_cronet.py build -i
```
or
```
    ~/chromium/src $ cr_cronet.py build -d out/Debug-iphoneos
```

## Updating

- Acquire the most recent version of the source with:
```
    ~/chromium/src $ cr_cronet.py sync
```
and then rebuild:
```
    ~/chromium/src $ cr_cronet.py build -d out/Debug-iphoneos
    ~/chromium/src $ cr_cronet.py build -d out/Debug-iphonesimulator
```

For more information, you can run
```
    ~ $ cr_cronet.py -h
```