The -migrate command applies a migration signature to an
AIR file. A migration signature must be used when you renew or change
your digital certificate and need to update applications signed
with the old certificate.
For more information about packaging AIR applications with a
migration signature, see Signing an updated version of an AIR application.
Note: The migration certificate must be applied within 365 days
from the expiration of the certificate. Once this grace period has
elapsed, your application updates can no longer be signed with a
migration signature. Users can first update to a version of your
application that was signed with a migration signature and then
install the latest update, or they can uninstall the original application
and install the new AIR package.
To use a migration signature, first sign your AIR application
using the new or renewed certificate (using the -package or -sign
commands), and then apply the migration signature using the old
certificate and the -migrate command.
The -migrate command uses the following syntax:
adt -migrate AIR_SIGNING_OPTIONS input output
AIR_SIGNING_OPTIONS The AIR signing options identifying
the original certificate that was used to sign existing versions
of the AIR application. The signing options are fully described
in ADT code signing options.
input The AIR file already signed with the NEW application
certificate.
output The name of the final package bearing signatures
from both the new and the old certificates.
The file names used for the input and output AIR files must be
different.
Note: The ADT migrate command cannot be used with AIR desktop applications
that include native extensions, because those applications are packaged
as native installers, not as .air files. To change certificates
for an AIR desktop application that includes a native extension,
package the application using the
ADT package command with the -migrate flag.