Merge "Add config_tether_* and entitlement resources"

<?xml version="1.0" encoding="utf-8"?>

<!-- Copyright (C) 2020 The Android Open Source Project

     Licensed under the Apache License, Version 2.0 (the "License");

     you may not use this file except in compliance with the License.

     You may obtain a copy of the License at

          http://www.apache.org/licenses/LICENSE-2.0

     Unless required by applicable law or agreed to in writing, software

     distributed under the License is distributed on an "AS IS" BASIS,

     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

     See the License for the specific language governing permissions and

     limitations under the License.

-->

<resources>

    <!--

    OEMs that wish to change the below settings must do so via a runtime resource overlay package

    and *NOT* by changing this file. This file is part of the tethering mainline module.

    TODO: define two resources for each config item: a default_* resource and a config_* resource,

    config_* is empty by default but may be overridden by RROs.

    -->

    <!-- List of regexpressions describing the interface (if any) that represent tetherable

         USB interfaces.  If the device doesn't want to support tethering over USB this should

         be empty.  An example would be "usb.*" -->

    <string-array translatable="false" name="config_tether_usb_regexs">

        <item>"usb\\d"</item>

        <item>"rndis\\d"</item>

    </string-array>

    <!-- List of regexpressions describing the interface (if any) that represent tetherable

         Wifi interfaces.  If the device doesn't want to support tethering over Wifi this

         should be empty.  An example would be "softap.*" -->

    <string-array translatable="false" name="config_tether_wifi_regexs">

        <item>"wlan\\d"</item>

        <item>"softap\\d"</item>

    </string-array>

    <!-- List of regexpressions describing the interface (if any) that represent tetherable

         Wifi P2P interfaces.  If the device doesn't want to support tethering over Wifi P2p this

         should be empty.  An example would be "p2p-p2p.*" -->

    <string-array translatable="false" name="config_tether_wifi_p2p_regexs">

    </string-array>

    <!-- List of regexpressions describing the interface (if any) that represent tetherable

         bluetooth interfaces.  If the device doesn't want to support tethering over bluetooth this

         should be empty. -->

    <string-array translatable="false" name="config_tether_bluetooth_regexs">

        <item>"bt-pan"</item>

    </string-array>

    <!-- Dhcp range (min, max) to use for tethering purposes -->

    <string-array translatable="false" name="config_tether_dhcp_range">

    </string-array>

    <!-- Array of ConnectivityManager.TYPE_{BLUETOOTH, ETHERNET, MOBILE, MOBILE_DUN, MOBILE_HIPRI,

         WIFI} values allowable for tethering.

         Common options are [1, 4] for TYPE_WIFI and TYPE_MOBILE_DUN or

         [1,7,0] for TYPE_WIFI, TYPE_BLUETOOTH, and TYPE_MOBILE.

         This list is also modified by code within the framework, including:

             - TYPE_ETHERNET (9) is prepended to this list, and

             - the return value of TelephonyManager.isTetheringApnRequired()

               determines how the array is further modified:

                   * TRUE (DUN REQUIRED).

                     TYPE_MOBILE is removed (if present).

                     TYPE_MOBILE_HIPRI is removed (if present).

                     TYPE_MOBILE_DUN is appended (if not already present).

                   * FALSE (DUN NOT REQUIRED).

                     TYPE_MOBILE_DUN is removed (if present).

                     If both of TYPE_MOBILE{,_HIPRI} are not present:

                        TYPE_MOBILE is appended.

                        TYPE_MOBILE_HIPRI is appended.

         For other changes applied to this list, now and in the future, see

         com.android.server.connectivity.tethering.TetheringConfiguration.

         Note also: the order of this is important. The first upstream type

         for which a satisfying network exists is used.

    -->

    <integer-array translatable="false" name="config_tether_upstream_types">

    </integer-array>

    <!-- When true, the tethering upstream network follows the current default

         Internet network (except when the current default network is mobile,

         in which case a DUN network will be used if required).

         When true, overrides the config_tether_upstream_types setting above.

    -->

    <bool translatable="false" name="config_tether_upstream_automatic">true</bool>

    <!-- If the mobile hotspot feature requires provisioning, a package name and class name

         can be provided to launch a supported application that provisions the devices.

         EntitlementManager will send an inent to Settings with the specified package name and

         class name in extras to launch provision app.

         TODO: note what extras here.

         See EntitlementManager#runUiTetherProvisioning and

         packages/apps/Settings/src/com/android/settings/network/TetherProvisioningActivity.java

         for more details.

         For ui-less/periodic recheck support see config_mobile_hotspot_provision_app_no_ui

        -->

    <!-- The first element is the package name and the second element is the class name

         of the provisioning app -->

    <string-array translatable="false" name="config_mobile_hotspot_provision_app">

    <!--

        <item>com.example.provisioning</item>

        <item>com.example.provisioning.Activity</item>

    -->

    </string-array>

    <!-- If the mobile hotspot feature requires provisioning, an action can be provided

         that will be broadcast in non-ui cases for checking the provisioning status.

         EntitlementManager will pass the specified name to Settings and Settings would

         launch provisioning app by sending an intent with the package name.

         A second broadcast, action defined by config_mobile_hotspot_provision_response,

         will be sent back to notify if provisioning succeeded or not.  The response will

         match that of the activity in config_mobile_hotspot_provision_app, but instead

         contained within the int extra "EntitlementResult".

         TODO: provide the system api for "EntitlementResult" extra and note it here.

         See EntitlementManager#runSilentTetherProvisioning and

         packages/apps/Settings/src/com/android/settings/wifi/tether/TetherService.java for more

         details.

        -->

    <string translatable="false" name="config_mobile_hotspot_provision_app_no_ui"></string>

    <!-- Sent in response to a provisioning check. The caller must hold the

         permission android.permission.TETHER_PRIVILEGED for Settings to

         receive this response.

         See config_mobile_hotspot_provision_response

         -->

    <string translatable="false" name="config_mobile_hotspot_provision_response"></string>

    <!-- Number of hours between each background provisioning call -->

    <integer translatable="false" name="config_mobile_hotspot_provision_check_period">24</integer>

    <!-- ComponentName of the service used to run no ui tether provisioning. -->

    <string translatable="false" name="config_wifi_tether_enable">com.android.settings/.wifi.tether.TetherService</string>

</resources>

<?xml version="1.0" encoding="utf-8"?>

<!-- Copyright (C) 2020 The Android Open Source Project

     Licensed under the Apache License, Version 2.0 (the "License");

     you may not use this file except in compliance with the License.

     You may obtain a copy of the License at

          http://www.apache.org/licenses/LICENSE-2.0

     Unless required by applicable law or agreed to in writing, software

     distributed under the License is distributed on an "AS IS" BASIS,

     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

     See the License for the specific language governing permissions and

     limitations under the License.

-->

<resources xmlns:android="http://schemas.android.com/apk/res/android">

    <overlayable name="TetheringConfig">

        <policy type="product|system|vendor">

            <item type="array" name="config_tether_usb_regexs"/>

            <item type="array" name="config_tether_wifi_regexs"/>

            <item type="array" name="config_tether_wifi_p2p_regexs"/>

            <item type="array" name="config_tether_bluetooth_regexs"/>

            <item type="array" name="config_tether_dhcp_range"/>

            <item type="array" name="config_tether_upstream_types"/>

            <item type="bool" name="config_tether_upstream_automatic"/>

            <!-- Configuration values for tethering entitlement check -->

            <item type="array" name="config_mobile_hotspot_provision_app"/>

            <item type="string" name="config_mobile_hotspot_provision_app_no_ui"/>

            <item type="string" name="config_mobile_hotspot_provision_response"/>

            <item type="integer" name="config_mobile_hotspot_provision_check_period"/>

            <item type="string" name="config_wifi_tether_enable"/>

        </policy>

    </overlayable>

</resources>