## Standard

lpac is written with C99 and compatible with [SGP.22 version 2.2.2](https://www.gsma.com/solutions-and-impact/technologies/esim/wp-content/uploads/2020/06/SGP.22-v2.2.2.pdf).

## Compile

### Linux

#### Debian/Ubuntu

With `build-essential` `cmake` `git` `g++` `libpcsclite-dev` `libcurl4-openssl-dev` installed.  
Run `cmake` and `make`, and then all things will be in `output` directory.  
If you want to get a Deb package, pass `-DCPACK_GENERATOR=DEB` when invoke `cmake`.

#### Droidian

Same as normal Debian/Ubuntu, however, in order to build the GBinder backends, you will need `libgbinder-dev`, `glib2.0-dev`, and you will have to pass `-DLPAC_WITH_APDU_GBINDER=ON` when invoking `cmake`.

### macOS

Install [Homebrew](https://brew.sh/).  
Run `cmake` and `make`, and then all things will be in `output` directory.

### Windows(x86_64)

Windows need prebuilt libcurl.dll.

#### Build on Linux(MINGW)

With `build-essential` `cmake` `git` `g++` `libpcsclite-dev` `libcurl4-openssl-dev` `gcc-mingw-w64` `g++-mingw-w64` installed.  
Run `cmake` and `make`, and then all things will be in `output` directory.  
Download libcurl from https://curl.se/download.html and place it as libcurl.dll in `output` directory.

#### Build on Windows(MSYS2)

With `mingw-w64-x86_64-cmake` `mingw-w64-x86_64-gcc` installed.  
Run `cmake` and `make`, and then all things will be in `output` directory.  
Download libcurl from https://curl.se/download.html and place it as libcurl.dll in `output` directory.

#### Build on Windows(Cygwin)

With `gcc-core` `gcc-g++` `make` `cmake` `unzip` `wget` installed.  
Run `cmake` and `make`, and then all things will be in `output` directory.  
Download libcurl from https://curl.se/download.html and place it as libcurl.dll in `output` directory.

To run it outside Cygwin shell, you need copy `cygwin1.dll` to the program folder to distribute.  
`cygwin1.dll` is located in `C:\cygwin64\bin\cygwin1.dll` (Default Cygwin installation location)

### Windows on ARM

#### Cross compile on Windows/Linux host(arm64,x86_64 and more architecture) with zig

Install [zig](https://ziglang.org/download/)

```bash
git clone https://github.com/estkme-group/lpac
cd lpac
./scripts/build.sh woa-zig
```

#### Cross compile on Linux x86_64 host(GNU toolchain)

```bash
git clone https://github.com/estkme-group/lpac
cd lpac
./scripts/build.sh woa-mingw
```

#### Build on Windows(MSYS2)

It is possible to build on **WoA devices** with [MSYS2 ARM64 Support](https://www.msys2.org/wiki/arm64/)

You may need to install `mingw-w64-clang-aarch64-cmake`, `mingw-w64-clang-aarch64-clang` and modify `cmake/linux-mingw64.cmake`(replace toolchain).

Download prebuilt curl dll is also needed. Refer to the previous compilation steps.

## Debug

Please see [debug environment variables](ENVVARS.md#debug)