The project is in a healthy, maintained state
Validate the IPA using altool.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
 Dependencies
 Project Readme

fastlane-plugin-validate_ipa

fastlane Plugin Badge Gem Version

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.