BUILD

sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer

cd FptnLib/
git submodule update --init --recursive

Xcode Integration (Recommended)

We have added a script to build this automatically when you build the iOS app.

1. Open FptnVPN.xcodeproj in Xcode
2. Go to FptnVPN target -> Build Phases
3. Add a New Run Script Phase at the very top
4. Name it "Build FptnLib" and set the script to: "${SRCROOT}/build_fptn_lib.sh"

Manual Build (Alternative)

./build_fptn_lib.sh

Local Secrets Bootstrap

Generate the local build/release credential handoff file once, then source it when you need it:

zsh ./scripts/bootstrap-ci-secrets.sh
source .env.local

The script writes .env.local for terminal use. If a local code signing identity is available, it lists the valid identities, lets you pick one, and exports + base64-encodes a .p12 for you.

If you want to upload CI secrets to GitHub, run:

zsh ./scripts/bootstrap-ci-secrets.sh --gh --gh-repo OWNER/REPO

The GitHub upload uses a curated subset of values (it intentionally excludes local-only values like KEYCHAIN_PASSWORD).

Localization (.xcstrings)

Xcode localization files live in:

• iOS: FptnVPN/Resources/Localizable.xcstrings
• macOS: Fptn-macOS/Resources/Localizable.xcstrings
• tvOS: Fptn-tvOS/Resources/Localizable.xcstrings

To make them easier to review/edit, use the TSV export/import helper:

python3 scripts/l10n_xcstrings.py export --all
python3 scripts/l10n_xcstrings.py report --all
python3 scripts/l10n_xcstrings.py compare

This writes artifacts to build/l10n/ (gitignored).

After editing a TSV (example: iOS):

python3 scripts/l10n_xcstrings.py import \
   --xcstrings FptnVPN/Resources/Localizable.xcstrings \
   --tsv build/l10n/ios.tsv \
   --in-place \
   --set-translated

For safety, you can use --dry-run, or write to a new file via --out <path>.

conan install . --profile:host=conan-device-profile --profile:build=default --build=missing --output-folder=build-ios 
cd build-ios
cmake .. -DCMAKE_TOOLCHAIN_FILE=./build/Debug/generators/conan_toolchain.cmake  -DCMAKE_BUILD_TYPE=Debug
cmake --build . --config Debug
copy to fptn-cpp


codesign --force --sign - --timestamp=none FptnVPN/Cpp/fptn_native_lib.framework/fptn_native_lib
codesign --force --sign - --preserve-metadata=identifier,entitlements,flags --timestamp=none FptnVPN/Cpp/fptn_native_lib.framework
codesign -dv FptnVPN/Cpp/fptn_native_lib.framework/fptn_native_lib