The packaging support was added to make it easier to distribute the migration scripts and to make use of them. While raw directory formats are still supported, it is usually cleaner to work with a packaged set of migration scripts as it reduces the number of steps needed to complete a database migration.
Supported packaging formats are zip and jar. No other formats are supported at this time.
The contents of the package must contain at the base a migrations.xml and a folder for each schema defined. Also, the only supported package formats are .zip and .jar.
An example of what a migration package called blog-db.zip might contain
migration.xml blog/ blog/1_down_clean.sql blog/1_up_initialize.sql blog/2_down_undo.sql blog/2_up_populate.sql