WebRTC Binaries for iOS and macOS

https://github.com/stasel/webrtc
Admin
This repository contains a community-driven distribution of WebRTC framework binaries for iOS and...
Tokens:19,177
Snippets:133
Trust Score:8.1
License:BSD-3-Clause
Update:1 month ago
Show doc for...
Tokens:
Raw
### Example usage of build.sh

Source: https://github.com/stasel/webrtc/blob/latest/_autodocs/api-reference/build-sh.md

Shows the expected invocation of build.sh from the repository root, passing configuration through environment variables such as BRANCH, MACOS, and IOS.

```sh
# Example usage (from the repository root): BRANCH=branch-heads/7727 MACOS=true IOS=true sh scripts/build.sh
```

--------------------------------

### Cocoapods install command

Source: https://github.com/stasel/webrtc/blob/latest/README.md

Run this command in your project directory to install the dependencies.

```bash
pod install
```

--------------------------------

### CocoaPods installation commands for WebRTC-lib

Source: https://github.com/stasel/webrtc/blob/latest/_autodocs/api-reference/distribution.md

Install the WebRTC-lib pod by adding it to the Podfile and running pod install. The podspec declares iOS 12.0 and macOS 10.11 deployment targets.

```ruby
# Podfile
pod 'WebRTC-lib'
# shell
pod install
```

--------------------------------

### Using release module functions from Python

Source: https://github.com/stasel/webrtc/blob/latest/_autodocs/api-reference/release-py.md

Shows how to check release availability, build, and get metadata before creating a draft. Requires GITHUB_TOKEN environment variable.

```python
import os, sys
os.environ["GITHUB_TOKEN"] = os.environ["GH_TOKEN"]
from scripts import release  # or: sys.path.insert(0, 'scripts'); import release

next_release = release.getNextRelease()
if not release.isReleaseAvailable(next_release):
    print("not available yet:", next_release.releaseDate)
    sys.exit(0)

if not release.buildWebRTC(next_release.branch):
    print("build failed")
    sys.exit(1)

meta = release.getBuildMetadata("./out")
print(meta.filename, meta.checksum, meta.commit)
draft = release.createReleaseDraft(next_release, meta)
print(draft.get("html_url"))
```

--------------------------------

### Carthage Cartfile and update command

Source: https://github.com/stasel/webrtc/blob/latest/_autodocs/api-reference/distribution.md

Installation steps from README.md: add the binary URL to a Cartfile, then run 'carthage update --use-xcframeworks' and embed the resulting xcframework in your target.

```text
# Cartfile
binary "https://raw.githubusercontent.com/stasel/WebRTC/latest/WebRTC.json"
```

```shell
carthage update --use-xcframeworks
# embed ./Carthage/Build/WebRTC.xcframework in your target
```

--------------------------------

### Automation metadata.json example

Source: https://github.com/stasel/webrtc/blob/latest/_autodocs/api-reference/distribution.md

JSON object written by scripts/build.sh and consumed by scripts/release.py. Contains file, checksum, commit, branch, and dsym fields for a WebRTC build.

```json
{ "file": "WebRTC-2025-09-21T12-00-00.xcframework.zip",
  "checksum": "<sha256>",
  "commit": "<WebRTC src commit>",
  "branch": "branch-heads/7727",
  "dsym": "WebRTC-2025-09-21T12-00-00-dSYM.zip" }
```

--------------------------------

### Cocoapods Podfile entry

Source: https://github.com/stasel/webrtc/blob/latest/README.md

Add this line to your Podfile to install WebRTC via Cocoapods.

```ruby
pod 'WebRTC-lib'
```

--------------------------------

### Import dependencies for release automation

Source: https://github.com/stasel/webrtc/blob/latest/_autodocs/api-reference/release-py.md

Imports required modules: `os`, `json`, `requests`, and `datetime`/`timedelta` from the standard library and third-party `requests` package. The `requests` library is installed in CI via `pip install requests`.

```python
import os
import json
import requests
from datetime import datetime, timedelta
from dataclasses import dataclass
```

--------------------------------

### Swift Package Manager dependency with branch

Source: https://github.com/stasel/webrtc/blob/latest/README.md

Use the 'latest' branch to get the most up-to-date binary.

```swift
dependencies: [
    .package(url: "https://github.com/stasel/WebRTC.git", branch: "latest")
]
```

--------------------------------

### build_iOS() function

Source: https://github.com/stasel/webrtc/blob/latest/_autodocs/api-reference/build-sh.md

Builds an iOS framework for the given architecture and environment (simulator or device). Generates a GN build directory under ${OUTPUT_DIR}/ios-<arch>-<environment>, dumps gn args to gn-args.txt, and builds the framework_objc target with ninja, exiting with code 1 on failure.

```sh
build_iOS() {
    local arch=$1
    local environment=$2
    local gen_dir="${OUTPUT_DIR}/ios-${arch}-${environment}"
    local gen_args="${COMMON_GN_ARGS} target_cpu=\"${arch}\" target_os=\"ios\" target_environment=\"${environment}\" ios_deployment_target=\"12.0\" ios_enable_code_signing=false"
    gn gen "${gen_dir}" --args="${gen_args}"
    gn args --list ${gen_dir} > ${gen_dir}/gn-args.txt
    ninja -C "${gen_dir}" framework_objc || exit 1
}
```

--------------------------------

### Carthage update command

Source: https://github.com/stasel/webrtc/blob/latest/README.md

Run this command to fetch and build the dependencies.

```bash
carthage update --use-xcframeworks
```

--------------------------------

### build_catalyst() function

Source: https://github.com/stasel/webrtc/blob/latest/_autodocs/api-reference/build-sh.md

Builds a Catalyst framework for the given architecture (x64 or arm64). Uses target_environment="catalyst", ios_deployment_target="14.0", and forces use_lld=false because Catalyst must link with Apple's linker instead of lld. Builds the framework_objc target with ninja.

```sh
build_catalyst() {
    local arch=$1
    local gen_dir="${OUTPUT_DIR}/catalyst-${arch}"
    local gen_args="${COMMON_GN_ARGS} target_cpu=\"${arch}\" target_environment=\"catalyst\" target_os=\"ios\" ios_deployment_target=\"14.0\" ios_enable_code_signing=false use_lld=false"
    gn gen "${gen_dir}" --args="${gen_args}"
    gn args --list ${gen_dir} > ${gen_dir}/gn-args.txt
    ninja -C "${gen_dir}" framework_objc || exit 1
}
```

--------------------------------

### Run build.sh in a subprocess and check return code

Source: https://github.com/stasel/webrtc/blob/latest/_autodocs/errors.md

Use this Python snippet to run the build script in a subprocess and check its return code. The build script never throws, so failures are detected via a non-zero return code. The environment includes a placeholder for additional variables and sets BRANCH and IOS.

```python
import subprocess

result = subprocess.run(["sh", "scripts/build.sh"], env={..., "BRANCH": "branch-heads/7727", "IOS": "true"})
if result.returncode != 0:
    print(f"build failed with exit {result.returncode}")
    # inspect out/ for partial artifacts, then run scripts/clean.sh
```

--------------------------------

### Typical CI invocation for release.py

Source: https://github.com/stasel/webrtc/blob/latest/_autodocs/api-reference/release-py.md

Used by CI (e.g., .github/workflows/webrtc-release.yml) to set the GITHUB_TOKEN, clean, and run the release script.

```bash
export GITHUB_TOKEN="${{ secrets.GITHUB_TOKEN }}"
sh scripts/clean.sh
python -u scripts/release.py
```

--------------------------------

### Carthage WebRTC.json binary project definition

Source: https://github.com/stasel/webrtc/blob/latest/_autodocs/api-reference/distribution.md

JSON mapping release version strings to xcframework zip URLs. Keys are version strings (e.g., 153.0.0) and values are download URLs. The file is sorted by key and updated by scripts/release.py.

```json
{
    "153.0.0": "https://github.com/stasel/WebRTC/releases/download/153.0.0/WebRTC-M153.xcframework.zip",
    "152.0.0": "https://github.com/stasel/WebRTC/releases/download/152.0.0/WebRTC-M152.xcframework.zip"
}
```

--------------------------------

### build_macOS() function

Source: https://github.com/stasel/webrtc/blob/latest/_autodocs/api-reference/build-sh.md

Builds a macOS framework for the given architecture (x64 or arm64). Uses the mac_framework_objc target, which differs from the iOS target name. Generates a GN build directory under ${OUTPUT_DIR}/macos-<arch> and dumps gn args to gn-args.txt.

```sh
build_macOS() {
    local arch=$1
    local gen_dir="${OUTPUT_DIR}/macos-${arch}"
    local gen_args="${COMMON_GN_ARGS} target_cpu=\"${arch}\" target_os=\"mac\""
    gn gen "${gen_dir}" --args="${gen_args}"
    gn args --list ${gen_dir} > ${gen_dir}/gn-args.txt
    ninja -C "${gen_dir}" mac_framework_objc || exit 1
}
```

--------------------------------

### Run release pipeline with set -e

Source: https://github.com/stasel/webrtc/blob/latest/_autodocs/errors.md

Shell script to run the release pipeline with set -e to stop on the first failure. The release script exits with code 70 (EX_SOFTWARE) on hard failure and 0 on success or the deliberate skip path.

```bash
# Shell: run the release pipeline and surface the first failure
set -e
sh scripts/clean.sh
python -u scripts/release.py   # exits 70 (EX_SOFTWARE) on hard failure, 0 on success/skip
```

--------------------------------

### Basic macOS build for branch-heads/7727

Source: https://github.com/stasel/webrtc/blob/latest/_autodocs/api-reference/build-sh.md

Basic build of macOS frameworks for the branch-heads/7727 branch. Sets BRANCH and MACOS environment variables and runs the build script.

```sh
BRANCH=branch-heads/7727 MACOS=true sh scripts/build.sh
```

--------------------------------

### plist_add_library - add library entry to Info.plist

Source: https://github.com/stasel/webrtc/blob/latest/_autodocs/api-reference/build-sh.md

Writes a dictionary entry into Info.plist for an XCFramework library slice, including LibraryIdentifier, LibraryPath, SupportedArchitectures, SupportedPlatform, and optionally SupportedPlatformVariant.

```sh
plist_add_library() {
    local index=$1
    local identifier=$2
    local platform=$3
    local platform_variant=$4
    ...
}
```

--------------------------------

### stage_dsym - copy and merge per-slice dSYMs

Source: https://github.com/stasel/webrtc/blob/latest/_autodocs/api-reference/build-sh.md

Copies WebRTC.dSYM to out/WebRTC-identifier.dSYM. For fat slices, merges two per-arch dSYMs with lipo -create. Exits 1 on copy/lipo failure.

```sh
stage_dsym() {
    local identifier=$1
    local build_dir=$2
    local extra_build_dir=$3
    ...
}
```

--------------------------------

### createReleaseDraft(release, buildMetadata)

Source: https://github.com/stasel/webrtc/blob/latest/_autodocs/api-reference/release-py.md

Creates a GitHub release draft via the GitHub API. Uses the provided release and build metadata to construct the release name, tag, and body.

```APIDOC
## createReleaseDraft(release, buildMetadata)

### Description
Creates a GitHub release draft via the GitHub API. The release name is `M{version}`, the tag is `{version}.0.0`, and the body includes links to release notes, branch, commit, and checksum.

### Method
POST

### Endpoint
`https://api.github.com/repos/{GITHUB_REPO}/releases`

### Parameters
#### Path Parameters
- **GITHUB_REPO** (string) - Required - The GitHub repository in the format `owner/repo`.

#### Request Body
- **name** (string) - Required - Release name, e.g., `M153`.
- **tag_name** (string) - Required - Tag name, e.g., `153.0.0`.
- **draft** (boolean) - Required - Always `true`.
- **body** (string) - Required - Release body containing links and checksum.

### Request Example
```json
{
  "name": "M153",
  "tag_name": "153.0.0",
  "draft": true,
  "body": "Release notes: https://webrtc.googlesource.com/src.git/+log/refs/branch-name/\nWebRTC Branch: [branch-name](https://chromium.googlesource.com/external/webrtc/+log/branch-name)\nWebRTC Commit: `commit-hash`\nSHA 256 checksum: `checksum`"
}
```

### Response
#### Success Response (200)
- **id** (number) - The release ID.
- **upload_url** (string) - URL for uploading assets.
- **html_url** (string) - URL to the release page.

#### Response Example
```json
{
  "id": 12345678,
  "upload_url": "https://api.github.com/repos/owner/repo/releases/12345678/assets{?name,label}",
  "html_url": "https://github.com/owner/repo/releases/tag/153.0.0"
}
```

### Errors
- **requests.RequestException** - Thrown on transport failure. The HTTP status is not verified.
```

--------------------------------

### getBuildMetadata(outputDir) function from scripts/release.py

Source: https://github.com/stasel/webrtc/blob/latest/_autodocs/api-reference/release-py.md

Reads metadata.json from the specified output directory and returns a BuildMetadata object. Raises KeyError, OSError, or json.JSONDecodeError if the file is missing or malformed.

```python
def getBuildMetadata(outputDir):
    with open(f"{outputDir}/metadata.json", 'r') as f:
        jsonData = json.loads(f.read())
        return BuildMetadata(filename = jsonData['file'], checksum = jsonData['checksum'], commit = jsonData['commit'], branch = jsonData['branch'], dsym = jsonData['dsym'])
```

--------------------------------

### Minimal debug build with error handling

Source: https://github.com/stasel/webrtc/blob/latest/_autodocs/api-reference/build-sh.md

Minimal debug build of one slice with error handling. Uses set -euo pipefail to exit on errors, enables debug symbols, and prints the build metadata after success.

```sh
set -euo pipefail
# Enable debug symbols and log GN args for inspection
DEBUG=true IOS=true sh scripts/build.sh
echo "build ok: $(cat out/metadata.json | tr -d '\n')"
```

--------------------------------

### createReleaseDraft: Create a GitHub release draft

Source: https://github.com/stasel/webrtc/blob/latest/_autodocs/api-reference/release-py.md

Creates a draft GitHub release via POST /releases. Uses release.version for the name and tag, and buildMetadata for the body. Returns the JSON response; throws requests.RequestException on transport failure but does not check HTTP status.

```python
def createReleaseDraft(release, buildMetadata):
    body = f"Release notes: https://webrtc.googlesource.com/src.git/+log/refs/{buildMetadata.branch}/\n"
    body += f"WebRTC Branch: [{buildMetadata.branch}](https://chromium.googlesource.com/external/webrtc/+log/{buildMetadata.branch})\n"
    body += f"WebRTC Commit: `{buildMetadata.commit}`\n"
    body += f"SHA 256 checksum: `{buildMetadata.checksum}`"

    fields = {
        'name': f'M{release.version}',
        'tag_name': f'{release.version}.0.0',
        'draft': True,
        'body': body
    }
    headers = {'accept': 'application/vnd.github.v3+json', 'Authorization': f'token {GITHUB_TOKEN}'}
    return requests.post(f"https://api.github.com/repos/{GITHUB_REPO}/releases", json = fields, headers = headers).json()
```

--------------------------------

### buildWebRTC(branch) function from scripts/release.py

Source: https://github.com/stasel/webrtc/blob/latest/_autodocs/api-reference/release-py.md

Builds WebRTC for a given branch by setting environment variables and running the build script. Returns True if the build succeeds (exit status 0).

```python
def buildWebRTC(branch):
    os.environ["BRANCH"] = branch
    os.environ["IOS"] = "true"
    os.environ["MACOS"] = "true"
    os.environ["MAC_CATALYST"] = "true"

    return os.system('sh scripts/build.sh') == 0
```

--------------------------------

### Full three-platform release build

Source: https://github.com/stasel/webrtc/blob/latest/_autodocs/api-reference/build-sh.md

Full three-platform release build as performed by scripts/release.py:buildWebRTC. Cleans previous checkouts, builds with all platforms enabled, and inspects the produced artifacts.

```sh
# Clean previous checkouts and output
sh scripts/clean.sh

# Debug=false, branch=main, all platforms
DEBUG=false BRANCH=main IOS=true MACOS=true MAC_CATALYST=true sh scripts/build.sh

# Inspect the produced artifacts
ls out/WebRTC-*.xcframework.zip out/WebRTC-*-dSYM.zip
cat out/metadata.json
```

--------------------------------

### Clean build artifacts and checkouts

Source: https://github.com/stasel/webrtc/blob/latest/_autodocs/configuration.md

Removes the depot_tools checkout, WebRTC source, and build output directories. Used by scripts/clean.sh to reset the environment.

```sh
rm -rf .cipd .gclient* depot_tools src .build out
```

--------------------------------

### Generate metadata.json with build info

Source: https://github.com/stasel/webrtc/blob/latest/_autodocs/types.md

Shell command that writes a JSON object with file, checksum, commit, branch, and dsym fields to metadata.json. The fields are populated from environment variables set during the build.

```sh
echo "{ \"file\": \"${OUTPUT_NAME}\", \"checksum\": \"${CHECKSUM}\", \"commit\": \"${COMMIT_HASH}\", \"branch\": \"${BRANCH}\", \"dsym\": \"${DSYM_OUTPUT_NAME}\" }" > metadata.json
```

--------------------------------

### Consumer dependency declarations for WebRTC package

Source: https://github.com/stasel/webrtc/blob/latest/_autodocs/api-reference/distribution.md

Shows two ways to declare the WebRTC package dependency: using upToNextMajor with version 153.0.0, or using the 'latest' branch for always-current binaries.

```swift
// latest release
dependencies: [
    .package(url: "https://github.com/stasel/WebRTC.git", .upToNextMajor("153.0.0"))
]

// always current binary
dependencies: [
    .package(url: "https://github.com/stasel/WebRTC.git", branch: "latest")
]
```

--------------------------------

### Swift import statement

Source: https://github.com/stasel/webrtc/blob/latest/README.md

Import WebRTC in your Swift code to use the framework.

```swift
import WebRTC
```

--------------------------------

### plist_add_architecture - add arch to SupportedArchitectures

Source: https://github.com/stasel/webrtc/blob/latest/_autodocs/api-reference/build-sh.md

Appends an architecture string to the slice's SupportedArchitectures array.

```sh
plist_add_architecture() {
    local index=$1
    local arch=$2
}
```

--------------------------------

### getNextRelease() function from scripts/release.py

Source: https://github.com/stasel/webrtc/blob/latest/_autodocs/api-reference/release-py.md

Determines the next WebRTC release version, date, and branch by querying GitHub and Chromium Dash APIs. Returns a NextReleaseResult. Terminates the process with os._exit(os.EX_SOFTWARE) if the stable milestone cannot be determined.

```python
def getNextRelease():
    # Get current version
    releases = requests.get(f"https://api.github.com/repos/{GITHUB_REPO}/releases", headers={'Authorization': f"token {GITHUB_TOKEN}"}).json()
    latestReleaseVersion = int(releases[0]["tag_name"].split(".")[0])
    latestReleaseDate = datetime.fromisoformat(releases[0]["published_at"].replace("Z", ""))
    print(f"Latest release: version {latestReleaseVersion}, date: {latestReleaseDate}")

    # Get the current stable milestone
    stableMilestone = getStableMilestone()
    if not stableMilestone:
        print("❌ Could not determine current stable milestone")
        os._exit(os.EX_SOFTWARE)

    nextReleaseVersion = max(latestReleaseVersion + 1, stableMilestone)
    if nextReleaseVersion > latestReleaseVersion + 1:
        print(f"Current stable milestone is M{stableMilestone}, skipping ahead from M{latestReleaseVersion + 1}")

    milestones = requests.get(f"https://chromiumdash.appspot.com/fetch_milestone_schedule?mstone={nextReleaseVersion}").json()
    nextReleaseDate = datetime.fromisoformat(milestones["mstones"][0]["stable_date"])
    print(f"Next release:   version {nextReleaseVersion}, date: {nextReleaseDate}")

    # Get next version branch
    releases = requests.get(f"https://chromiumdash.appspot.com/fetch_milestones?mstone={nextReleaseVersion}").json()
    nextReleaseBranch = "branch-heads/" + releases[0]["webrtc_branch"]

    return NextReleaseResult(version = nextReleaseVersion, releaseDate = nextReleaseDate, branch = nextReleaseBranch)
```

--------------------------------

### isReleaseAvailable(release) function from scripts/release.py

Source: https://github.com/stasel/webrtc/blob/latest/_autodocs/api-reference/release-py.md

Checks if a release is available by comparing today's date to the release date plus one day. Returns True if today is at or after the stable date plus one day (grace period).

```python
def isReleaseAvailable(release):
    return datetime.today() >= (release.releaseDate + timedelta(days=1))
```

--------------------------------

### Carthage Cartfile dependency

Source: https://github.com/stasel/webrtc/blob/latest/README.md

Add this line to your Cartfile to use WebRTC via Carthage.

```ruby
binary "https://raw.githubusercontent.com/stasel/WebRTC/latest/WebRTC.json"
```

--------------------------------

### Swift Package Manager Package.swift for WebRTC

Source: https://github.com/stasel/webrtc/blob/latest/_autodocs/api-reference/distribution.md

Defines the WebRTC package with a binary target pointing to the M153 release. Declares iOS 10 and macOS 10.11 platforms and includes the SHA-256 checksum validated by SwiftPM.

```swift
// swift-tools-version:5.3
import PackageDescription

let package = Package(
    name: "WebRTC",
    platforms: [.iOS(.v10), .macOS(.v10_11)],
    products: [
        .library(
            name: "WebRTC",
            targets: ["WebRTC"]),
    ],
    dependencies: [ ],
    targets: [
        .binaryTarget(
            name: "WebRTC",
            url: "https://github.com/stasel/WebRTC/releases/download/153.0.0/WebRTC-M153.xcframework.zip",
            checksum: "3e3a8946f27510133e3feed04d05fa23505bbe366e977620503bfc7986c2b78f"
        ),
    ]
)
```

--------------------------------

### uploadReleaseAsset: Upload a release asset to GitHub

Source: https://github.com/stasel/webrtc/blob/latest/_autodocs/api-reference/release-py.md

Uploads a local file to the GitHub release upload URL. Strips the {?name,label} template suffix, sets Content-Type to Application/zip, and returns True only if the response status is 201 Created. Prints the response on failure.

```python
def uploadReleaseAsset(url, assetLocalPath, assetName):
    url = url.replace(u'{?name,label}','')
    fileToUpload = open(assetLocalPath, 'rb')
    size = os.stat(assetLocalPath).st_size
    params = {'name': assetName}
    headers = {'Authorization': f'token {GITHUB_TOKEN}', 'Content-Length': str(size), 'Content-Type': 'Application/zip'}
    response = requests.post(url, params = params, data = fileToUpload, headers = headers)
    success = response.status_code == requests.codes.created
    if not success:
        print(response)
    return success
```

--------------------------------

### Swift Package Manager dependency with version

Source: https://github.com/stasel/webrtc/blob/latest/README.md

Add this dependency to your Package.swift file to use WebRTC with a specific version (e.g., 153.0.0).

```swift
dependencies: [
    .package(url: "https://github.com/stasel/WebRTC.git", .upToNextMajor("153.0.0"))
]
```

--------------------------------

### Define dataclasses for release metadata

Source: https://github.com/stasel/webrtc/blob/latest/_autodocs/api-reference/release-py.md

Defines `NextReleaseResult` and `BuildMetadata` dataclasses used to hold release version, date, branch, and build artifact information. These are referenced in the release workflow.

```python
@dataclass
class NextReleaseResult:
    version: int
    releaseDate: datetime
    branch: str

@dataclass
class BuildMetadata:
    filename: str
    checksum: str
    commit: str
    branch: str
    dsym: str
```

--------------------------------

### getStableMilestone() - fetch stable Chromium milestone

Source: https://github.com/stasel/webrtc/blob/latest/_autodocs/api-reference/release-py.md

Queries the Chromium Dashboard to find the highest numbered milestone with `schedule_phase` equal to `"stable"`. Returns an integer or `None` on failure. Prints warnings on non-success paths and never raises exceptions.

```python
def getStableMilestone():
    """Find the current stable milestone from the Chromium Dashboard."""
    try:
        response = requests.get("https://chromiumdash.appspot.com/fetch_milestones")
        response.raise_for_status()
        milestones = response.json()
        stable = [m for m in milestones if m.get("schedule_phase") == "stable"]
        if stable:
            return int(max(stable, key=lambda m: m["milestone"])["milestone"])
        print("Warning: no milestone with schedule_phase 'stable' found")
    except (requests.RequestException, KeyError, ValueError, TypeError) as e:
        print(f"Warning: failed to fetch stable milestone: {e}")
    return None
```

--------------------------------

### uploadReleaseAsset(url, assetLocalPath, assetName)

Source: https://github.com/stasel/webrtc/blob/latest/_autodocs/api-reference/release-py.md

Uploads a local file as an asset to a GitHub release using the provided upload URL. Returns true if the upload succeeds with a 201 status.

```APIDOC
## uploadReleaseAsset(url, assetLocalPath, assetName)

### Description
Uploads a local file to a GitHub release as an asset. The upload URL is the release's `upload_url` with the `{?name,label}` suffix stripped. Returns `True` if the upload is successful (HTTP 201).

### Method
POST

### Endpoint
`{upload_url}` (after removing `{?name,label}`)

### Parameters
#### Path Parameters
- **upload_url** (string) - Required - The GitHub release upload URL.

#### Query Parameters
- **name** (string) - Required - The remote asset name, e.g., `WebRTC-M153.xcframework.zip`.

#### Request Body
- **file** (binary) - Required - The local file content to upload.

### Request Example
```
POST /repos/owner/repo/releases/12345678/assets?name=WebRTC-M153.xcframework.zip HTTP/1.1
Host: api.github.com
Authorization: token GITHUB_TOKEN
Content-Type: Application/zip
Content-Length: 12345

<binary data>
```

### Response
#### Success Response (201)
- **id** (number) - The asset ID.
- **name** (string) - The asset name.
- **browser_download_url** (string) - URL to download the asset.

#### Response Example
```json
{
  "id": 98765432,
  "name": "WebRTC-M153.xcframework.zip",
  "browser_download_url": "https://github.com/owner/repo/releases/download/153.0.0/WebRTC-M153.xcframework.zip"
}
```

### Errors
- Returns `False` if the response status is not `201 Created`. Prints the response object on failure.
```

--------------------------------

### BuildMetadata dataclass

Source: https://github.com/stasel/webrtc/blob/latest/_autodocs/types.md

Defines the BuildMetadata dataclass with fields filename, checksum, commit, branch, and dsym. Produced by getBuildMetadata() and consumed by createReleaseDraft().

```python
@dataclass
class BuildMetadata:
    filename: str
    checksum: str
    commit: str
    branch: str
    dsym: str

```

--------------------------------

### createPullRequest(release, head)

Source: https://github.com/stasel/webrtc/blob/latest/_autodocs/api-reference/release-py.md

Creates a pull request against the 'latest' base branch using the GitHub API. Returns true if the PR is created successfully.

```APIDOC
## createPullRequest(release, head)

### Description
Creates a pull request in the GitHub repository with the base branch `latest`. The PR title and body are generated from the release version.

### Method
POST

### Endpoint
`https://api.github.com/repos/{GITHUB_REPO}/pulls`

### Parameters
#### Path Parameters
- **GITHUB_REPO** (string) - Required - The GitHub repository in the format `owner/repo`.

#### Request Body
- **title** (string) - Required - PR title, e.g., `Release M153`.
- **head** (string) - Required - Source branch, e.g., `release-M153`.
- **base** (string) - Required - Always `latest`.
- **body** (string) - Required - PR description, e.g., `Updated files for release M153.`

### Request Example
```json
{
  "title": "Release M153",
  "head": "release-M153",
  "base": "latest",
  "body": "Updated files for release M153."
}
```

### Response
#### Success Response (201)
- **number** (number) - The PR number.
- **html_url** (string) - URL to the PR.
- **state** (string) - The PR state, e.g., `open`.

#### Response Example
```json
{
  "number": 42,
  "html_url": "https://github.com/owner/repo/pull/42",
  "state": "open"
}
```

### Errors
- Returns `False` if the response status is not `201 Created`. Prints the response object on failure.
```

--------------------------------

### Environment variable defaults for build script

Source: https://github.com/stasel/webrtc/blob/latest/_autodocs/api-reference/build-sh.md

Reads environment variables with defaults: DEBUG defaults to false, BRANCH to main, and platform switches (IOS, MACOS, MAC_CATALYST) to false. These are used to control the build.

```sh
DEBUG="${DEBUG:-false}"
BRANCH="${BRANCH:-main}"
IOS="${IOS:-false}"
MACOS="${MACOS:-false}"
MAC_CATALYST="${MAC_CATALYST:-false}"
```

--------------------------------

### COMMON_GN_ARGS shell variable definition

Source: https://github.com/stasel/webrtc/blob/latest/_autodocs/configuration.md

Defines the COMMON_GN_ARGS variable used in build.sh, applied to every platform slice. Sets build options like debug mode, VP9 support, component build, tests, symbol export, stripping, dSYMs, linker, OpenGL rendering, and codec support.

```sh
COMMON_GN_ARGS="is_debug=${DEBUG} rtc_libvpx_build_vp9=true is_component_build=false rtc_include_tests=false rtc_enable_objc_symbol_export=true enable_stripping=true enable_dsyms=true use_lld=true rtc_ios_use_opengl_rendering=true rtc_system_openh264=true rtc_use_h265=true"
```

--------------------------------

### fix_privacy_manifest - repair macOS/Catalyst framework layout

Source: https://github.com/stasel/webrtc/blob/latest/_autodocs/api-reference/build-sh.md

Moves PrivacyInfo.xcprivacy from a nested Versions/A/Versions path to the correct location and removes the nested directory. Exits 1 on failure. Applied to macOS and Catalyst slices.

```sh
fix_privacy_manifest() {
    local framework=$1
    local nested="${framework}/Versions/A/Versions"
    if [ -f "${nested}/A/Resources/PrivacyInfo.xcprivacy" ]; then
        mv "${nested}/A/Resources/PrivacyInfo.xcprivacy" "${framework}/Versions/A/Resources/" || exit 1
        rm -rf "${nested}"
    fi
}
```

--------------------------------

### NextReleaseResult dataclass

Source: https://github.com/stasel/webrtc/blob/latest/_autodocs/types.md

Defines the NextReleaseResult dataclass with fields version, releaseDate, and branch. Produced by getNextRelease() and consumed by several release functions.

```python
@dataclass
class NextReleaseResult:
    version: int
    releaseDate: datetime
    branch: str

```
Tokens:
Raw