Use the customization samples

  • Article

Partners can download and use the sample customization answer files to get started with customizing Windows Phone 8.1.

  • To obtain the sample customization answer files
    Download the WPBlue_Customization_Code_Samples.zip file from the Connect site. This .zip contains sample customization answer files for the majority of customizations documented in this section.

    For a list of all customization samples, see Customization samples index.

  • To use the sample customization answer files and build a custom phone image

    1. Ensure that you have an updated kit installation, and that you can build a phone image using it and flash that image to your engineering device.

    2. If you have not already done so, create a folder for your packages in %WPDKCONTENTROOT%. Name the folder OEMCustomizationPackages or give it a similar name so you know this folder contains all your customizations. Note that this folder can include many subfolders.

    3. Copy a sample customization folder from WPBlue_Customization_Code_Samples.zip to the OEMCustomizationPackages folder.

    4. Open the sample XML customization answer file and modify it to optionally change the values from the sample customization answer file and provide any required values:

      Note  

      The values used in the root customization answer file (or the one you specify as the input customization answer file during ImgGen.cmd or CustomizationGen.cmd in Step 6) is used to determine the package owner so it is important to provide these required values.

      • Name

      • Description

      • Owner

      • OwnerType (in the customization samples this is typically already set to 'OEM').

      • Any files, assets, or other settings specific to the customization. See the corresponding topic in the Customization and runtime configuration section of the documentation for more information about what to change and how.

      You must also update or replace any additional files included in the sample folder. Instructions are provided in the customization topic in the documentation.

      Note that you’ll be using the customization answer file as one of the inputs when building your customization package or OS image.

    5. Open a Developer Command Prompt for VS2013 window (if you have installed Visual Studio 2013) or a Command Prompt window (if you have not installed Visual Studio 2013) as an administrator. Configure the environment variables in this window as described in the Set up environment variables section of Preparing for Windows Phone development.

    6. Depending on what you want to do, you can use the customization answer file to create a package containing your customization(s) or use the answer file as one of the inputs to create an OS image.

      • To use the customization answer file to generate a package without building an OS image, see Generating customization packages without creating an image in Building a phone image using ImgGen.cmd to find out how to use CustomizationGen.cmd.

      • To build an image as an .ffu file using the customization answer file as one of the inputs, see Using ImgGen.cmd to generate the image in Building a phone image using ImgGen.cmd to find out how to use ImgGen.cmd.

    7. Flash the .ffu file to a phone. For more information, see Use the flashing tools provided by Microsoft.

    8. See the Testing steps section in the corresponding customization topic to verify that the customization has been configured properly.

 

 

Send comments about this topic to Microsoft