Libbox for iOS

A Sing-Box build workflow for iOS. This repository automates the creation of an .xcframework named Libbox for integration into iOS apps.

Overview

What is Sing-Box?

Sing-Box is a versatile proxy platform maintained by the SagerNet community. It offers a robust set of features for traffic management, encryption, and routing. This repository focuses on building Sing-Box’s iOS library as a self-contained .xcframework for easier app integration.

Why Libbox?

Libbox is the name we’ve given to the compiled framework for Apple platforms. Instead of manually configuring a complex build environment for Sing-Box on iOS, you can use this ready-made .xcframework in your apps.

How It Works

1. Daily Release Check

   • We have a GitHub Actions workflow that runs every day at 12:10 UTC.
   • It queries the SagerNet/sing-box repository for the latest release tag (e.g. v1.10.5).

2. Automatic Build & Release

   • If a new tag is found, the workflow checks out the Sing-Box source code, builds the iOS library, zips the resulting .xcframework, calculates its checksum, and updates our Package.swift with the new version and checksum.
   • A GitHub Release is then created in this repo, attaching Libbox.xcframework.zip.

3. Manual Trigger

   • If desired, you can also manually trigger the build workflow via GitHub Actions (workflow_dispatch). Simply provide the version and tag in the inputs.