Quick Start - Monitor for iOS
Get ByteHide Monitor protecting your iOS application in under 5 minutes using cloud zero-config setup.
Prerequisites
- Xcode 14+ with CocoaPods or Swift Package Manager
- A ByteHide account with a Monitor project (create one here)
- Your ByteHide Project Token from cloud.bytehide.com
Step 1: Install Monitor
Using CocoaPods (Recommended)
Add to your Podfile:
Ruby
platform :ios, '12.0'
target 'YourApp' do
use_frameworks!
pod 'ByteHideMonitor', '~> 1.0.0'
endplatform :ios, '12.0'
target 'YourApp' do
use_frameworks!
pod 'ByteHideMonitor', '~> 1.0.0'
endThen run:
Bash
pod installpod installUsing Swift Package Manager
- In Xcode, go to File > Add Package Dependencies...
- Enter URL:
https://github.com/bytehide/bytehide-monitor - Set version to
1.0.0or later - Add to your target
Step 2: Set Your Token
Configure the BYTEHIDE_TOKEN environment variable in your Xcode scheme:
- Edit Scheme > Run > Arguments > Environment Variables
- Add:
BYTEHIDE_TOKEN=your-project-token
Step 3: Build and Run
Build your project in Xcode.
Bash
xcodebuild -workspace YourApp.xcworkspace -scheme YourApp -configuration Releasexcodebuild -workspace YourApp.xcworkspace -scheme YourApp -configuration ReleaseAuto-Initialization
Monitor for iOS auto-initializes using the Objective-C +load() method, which executes before main(). This means protection is active from the earliest point of your app's execution. No code changes required in cloud configuration mode.
What Happens at Runtime
- During build, the token is validated and configuration is embedded in the app bundle
- At runtime, Monitor auto-initializes before
main()via+load() - Validates the app signature and activates configured protections
- Syncs with the ByteHide dashboard for configuration updates