English | 한국어 | 日本語

fastlane-plugin-validate_ipa

A fastlane plugin that validates IPA files with Apple's altool before they are uploaded to App Store Connect. This plugin is a maintained replacement for 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 a 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 it 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.