visionOS Builds

Build NativeScript applications for Apple Vision Pro with visionOS support.

Requirements

Development Environment

• Xcode 15+ with visionOS SDK
• macOS Sonoma or later

NativeScript Support

• NativeScript 8.6+ with visionOS support
• visionOS-compatible plugins

Building for visionOS

Debug Build

norrix build visionos debug

Release Build

norrix build visionos release appstore

Distribution Types

Same as iOS:

Code Signing

visionOS uses the same signing mechanisms as iOS:

With ASC API

norrix build visionos release appstore \
  --asc-key-id ABC123DEF4 \
  --asc-issuer-id 12345678-1234-1234-1234-123456789012 \
  --asc-key ./AuthKey.p8

With Manual Certificates

norrix build visionos release appstore \
  --p12 ./certs/distribution.p12 \
  --p12-password $P12_PASSWORD \
  --profile ./profiles/VisionOS.mobileprovision

Configuration

// norrix.config.ts
import { defineConfig } from '@norrix/cli';
 
export default defineConfig({
  ios: {
    teamId: 'ABC123XYZ0',
    distributionType: 'appstore',
  },
  defaultPlatform: 'visionos',
});

OTA Updates

OTA updates work the same as iOS:

# Publish visionOS update
norrix update visionos 1.0.1

The SDK handles visionOS platform detection automatically.

Considerations

Spatial UI

• visionOS apps may need spatial UI adaptations
• Consider depth and 3D elements
• Test in Vision Pro simulator

Plugins

• Verify plugin visionOS compatibility
• Some iOS plugins may not work directly
• Check for visionOS-specific implementations

Performance

• Optimize for spatial computing
• Consider rendering requirements
• Test on actual hardware when possible