fastlane-plugin-validate_ipa

A fastlane plugin that validates IPA files using Apple's altool before uploading to App Store Connect. This plugin improves upon the unmaintained validate_app plugin.

Features

• IPA file validation — Verifies file existence and extension before running altool
• Structured error reporting — Parses altool XML output and displays numbered error list with failure reasons
• Fallback error handling — Gracefully handles missing fields, empty responses, and unparseable output
• Sensitive parameter masking — Passwords are masked in fastlane logs

Installation

fastlane add_plugin validate_ipa

Or add to your Gemfile:

gem 'fastlane-plugin-validate_ipa'

Usage

lane :validate do
  validate_ipa(
    path: "build/MyApp.ipa",
    platform: "ios",
    username: "your@apple.id",
    password: "app-specific-password"
  )
end

If your Apple ID uses two-factor authentication, pass an app-specific password.

Parameters

Key	Description	Env Var	Required
path	Path to the IPA file	FL_VALIDATE_IPA_PATH	Yes
platform	Target platform (ios or macos)	FL_VALIDATE_IPA_PLATFORM	Yes
username	Apple ID	FL_VALIDATE_IPA_USERNAME	Yes
password	App-specific password	FL_VALIDATE_IPA_PASSWORD	Yes

License

This project is licensed under the MIT License - see the LICENSE file for details.