Extracting a Source Archive from an FPR File

The FPRUtility -sourceArchive option creates a source archive (FSA) file from a specified FPR file and removes the source code from the FPR file. You can extract the source code from an FPR file, merge an existing source archive (FSA) back into an FPR file, or recover source files from a source archive.

To archive data:

FPRUtility -sourceArchive -extract -project <project>.fpr -f <output_archive>.fsa

To archive data to a directory:

FPRUtility -sourceArchive -extract -project <project>.fpr \
-recoverSourceDirectory -f <output_dir>

To add an archive to an FPR file:

FPRUtility -sourceArchive -mergeArchive -project <project>.fpr \ 
-source <old_source_archive>.fsa -f <project_with_archive>.fpr

To recover files that are missing from an FPR file:

FPRUtility -sourceArchive -fixSecondaryFileSources \
-payload <source_archive>.zip -project <project>.fpr -f <output>.fpr

FPRUtility Source Archive Options

The following table lists the FPRUtility options that apply to working with the source archive.

FPRUtility Option Description

-sourceArchive

Creates an FSA file so that you can extract a source archive.

One of:

-extract

-mergeArchive

-fixSecondaryFileSources

Use the -extract option to extract the contents of the FPR file.

Use the -mergeArchive option to merge the contents of the FPR file with an existing archived file (-source option).

Use the -fixSecondaryFileSources option to recover source files from a source archive (-payload option) missing from an FPR file.

-project <project>.fpr

Specifies the FPR to archive.
-recoverSourceDirectory

Use with the -extract option to extract the source as a directory with restored source files.

-source <old_source_archive>.fsa

Specifies the name of the existing archive. Use only if you are merging an FPR file with an existing archive (-mergeArchive option).

-payload <source_archive>.zip

Use with the -fixSecondaryFileSources option to specify the source archive from which to recover source files.

-f <project_with_archive>.fpr |

<output_archive>.fsa |

<output_dir>

Specifies the output file. You can generate an FPR, a directory, or an FSA file.

-debug

Displays debug information that can be helpful to troubleshoot issues with FPRUtility.