iOS

Build, sign, validate, and publish IPA files to the App Store using Xcode and Jenkins — with full no-code automation when using Opsera's managed script type.

Infrastructure configuration is required before use. Contact [email protected] to enable iOS pipeline support for your account.

Prerequisites

• Opsera infrastructure configuration completed (contact Opsera to enable)

• iOS distribution certificate (.p12) uploaded to the Jenkins tool in Tool Registry

• SCM account with iOS project repository registered

• Provisioning profile path available for your app

Pipeline Setup

1

Upload .p12 certificate

Tool Registry → Jenkins tool → Accounts tab → New Jenkins Account Credential. Set Platform to Certificate, upload the .p12 file, enter password, credential name, and description.

2

Create Build Step

Tool = Jenkins, Step Type = Build. Select Jenkins Tool, set Job Type to Opsera Managed Job, and choose the Xcode version.

Supported Xcode versions
11.7 · 12.5 · 13.4.1 · 14.3 · 15.0.1 · 16.1

3

Configure iOS settings

Select Certificate, Provisioning Profile Path, Scheme Name, and Configuration Type (Release / Debug). Set Script Type to Opsera for full no-code automation or Custom for manual commands.

4

Enable App Store upload

Toggle Validate and Upload App on. If Script Type = Opsera, leave Output File Path empty — the IPA is placed automatically in a Release folder in Jenkins.

What Opsera auto-mode handles

• Extracts SHA1 certificate fingerprint from the .p12 file

• Copies provisioning profile and decodes entitlements

• Removes NFC reader entitlements and re-signs the app with correct entitlements

• Builds archive, exports IPA, validates against App Store requirements, and uploads

Points to remember

• Only .p12 certificate files are supported — PEM or CER formats are not accepted by the Jenkins tool credential uploader.

• When using Custom Script Type, you must specify the Output File Path explicitly (e.g.sample/*.ipa).

• Use Release configuration for App Store builds and Debug for development/QA builds — this affects code optimization and symbol generation.?FAQs

FAQs

What does Opsera script automate early?

Opsera mode handles the full iOS build lifecycle: certificate extraction, provisioning, entitlement management, re-signing, IPA export, App Store validation, and upload — without any manual scripts.

Can I use a custom path?

Yes, but only when Script Type is set to Custom. Enter the path in Output File Path (e.g. sample/*.ipa). For Opsera script type, the path is managed automatically.

Where do I find pipeline logs?

Open the pipeline → Summary tab → Pipeline Logs → click Console Output in the Action column.