One common issue with updating packages is the migration of editable files, either moving between packages or changing location in the installed file system.
Migrating editable files between packages.
IPS attempts to migrate editable files that move between packages if the file name and file path have not changed. Renaming a package is an example of moving files between packages.
Migrating editable files in the file system.
If the file path changes, ensure the original_name attribute is assigned to preserve the user’s customizations of the file.
If the file action in the package that originally delivered this file does not contain the original_name attribute, add that attribute in the updated package. Set the value of the attribute to the name of the originating package, followed by a colon and the original path to the file without a leading /.
Once the original_name attribute is present on an editable file, do not change the attribute value. This value acts as a unique identifier for all moves going forward so that the user’s content is properly preserved regardless of the number of versions skipped on an update.