Additional Internet APN settings

OEMs can hide both the add internet apn button and the IP type listbox in the internet APN settings screen.

If it is required by the mobile operator OEMs can hide the add internet apn button, which enables the user to manually add and configure a data connection for a network. OEMs can also hide the IP type listbox in the internet APN settings screen.

Limitations and restrictions:

  • Partners must not provide an alternate user interface for adding or editing APN values.

Constraints: None
This customization supports: per-IMSI value, per-device value

Instructions:

  1. Create a customization answer file using the contents shown in the following code sample.

    <?xml version="1.0" encoding="utf-8" ?>  
    <ImageCustomizations xmlns="http://schemas.microsoft.com/embedded/2004/10/ImageUpdate"  
                         Name="InternetAPNSettings"  
                         Description="Use to hide or show the 'add internet apn' button in the SIM settings screen,
                                      and hide or show the 'IP type' setting in the internet APN settings screen."  
                         Owner=""  
                         OwnerType="OEM"> 
    
    
    
        <!-- Use for the per-IMSI case 
    
          <!-- Define the Targets --> 
          <Targets>
             <Target Id="">
                <TargetState>
                   <Condition Name="" Value="" />
                   <Condition Name="" Value="" />
                </TargetState>
             </Target>
          </Targets>
    
          <Static>
            <Settings Path="Multivariant">
              <Setting Name="Enable" Value="1" />
            </Settings>
            <Settings Path="AutoDataConfig">
              <Setting Name="Enable" Value="0" />
            </Settings>
          </Static>
    
          <!-- Specify the Variant -->
          <Variant Name=""> 
            <TargetRefs>
              <TargetRef Id="" /> 
            </TargetRefs>
    
            <Settings Path="CellCore/PerIMSI/$(__IMSI)/CellUX">   
              <Setting Name="HideAPN" Value="" />  
              <Setting Name="HideAPNIPType" Value="" />      
              <Setting Name="APNIPTypeIfHidden" Value="" />      
            </Settings>  
          </Variant>
    
        -->
    
        <!-- Use for the per-device case
    
          <Static>  
             <Settings Path="CellCore/PerDevice/CellUX">  
              <Setting Name="HideAPN" Value="" />  
              <Setting Name="HideAPNIPType" Value="" />      
              <Setting Name="APNIPTypeIfHidden" Value="" />      
            </Settings>  
          </Static>
    
        -->
    
        </ImageCustomizations>
    
  2. Specify an Owner.

  3. Determine if you need to use the per-IMSI or per-device setting.

    For the per-IMSI case:

    1. Define Targets or conditions for when a variant can be applied, such as keying off a SIM's MCC, MNC, and SPN.

    2. Define settings for a Variant, which are applied if the associated target's conditions are met.

  4. Set the value for HideAPN to one of the following:

    Value Description

    0 or 'No'

    Shows the add internet APN button in the SIM settings screen.

    1 or 'Yes'

    Hides the add internet APN button in the SIM settings screen.

  5. Set the value for HideAPNIPType to one of the following:

    Value Description

    0 or 'No'

    Shows the IP type listbox in the internet APN settings screen.

    1 or 'Yes'

    Hides the IP type listbox in the internet APN settings screen.

  6. To change the default IP type shown in the IP type listbox: Set the value for APNIPTypeIfHidden to one of the following:

    Value Description

    0 or 'IPV4'

    Sets the default IP type to IPv4.

    1 or 'IPV6'

    Sets the default IP type to IPv6.

    2 or 'IPV4V6'

    Sets the default IP type to IPv4v6.

    3 or 'IPV4V6XLAT'

    Sets the default IP type to IPv4v6 XLAT.

Testing:

  1. Flash the build containing this customization to a device.

  2. Go to the cellular & SIM screen in Settings.

  3. Verify that the add internet apn button is no longer visible if configured to be hidden.

  4. Tap the add internet apn button. Depending on the setting, verify that:

    1. The IP type setting either shows a dropdown listbox with IPv4, IPv6, IPv4v6, or IPv4v6 464XLAT. Or,

    2. The IP type setting is hidden.

Prepare for Windows mobile development

Customization answer file overview