Android Auto OS 13 及更高版本包含允许您配置和管理以太网网络的功能。图 1 显示了汽车的网络图示例
图 1. Android Auto 网络。
此图显示了您的 OEM 网络应用调用 EthernetManager 类中的方法来配置和管理车载以太网网络（eth0.1、eth0.2 和 eth0.3）。图 1 的其余部分不在本文档的讨论范围内。
设置默认以太网网络设置
要设置默认网络设置，请使用 资源叠加层 config_ethernet_interfaces
<string-array translatable="false" name="config_ethernet_interfaces">
<!--
<item>eth1;12,13,14,15;ip=192.168.0.10/24 gateway=192.168.0.1 dns=4.4.4.4,8.8.8.8</item>
<item>eth2;;ip=192.168.0.11/24</item>
<item>eth3;12,13,14,15;ip=192.168.0.12/24;1</item>
-->
</string-array>
此示例显示了 config.xml 中的 config_ethernet_interfaces 资源叠加层。
关于代码的要点
eth1、eth2和eth3是正在配置的网络接口的名称。12、13、14、15的连续数字表示已启用的网络功能。ip=、gateway=和dns用于设置网络的初始 IP 地址、网关和 DNS。
启用或停用网络接口
要启用网络接口，请调用 EthernetManager.enableInterface()
public final class InterfaceEnabler {
private final Context mApplicationContext;
private final EthernetManager mEthernetManager;
private final OutcomeReceiver<String, EthernetNetworkManagementException> mOutcomeReceiver;
public InterfaceEnabler(Context applicationContext,
OutcomeReceiver<String, EthernetNetworkManagementException> outcomeReceiver) {
mApplicationContext = applicationContext;
mEthernetManager = applicationContext.getSystemService(EthernetManager.class);
mOutcomeReceiver = outcomeReceiver;
}
public void enableInterface(String ifaceName) {
mEthernetManager.enableInterface(ifaceName,
mApplicationContext.getMainExecutor(),
mOutcomeReceiver);
}
}
关于代码的要点
ifaceName是要启用的网络接口的名称。getMainExecutor()返回应用上下文。OutcomeReceiver是一个回调，用于传递完成情况，成功时返回更新后的网络名称，出错时返回EthernetNetworkManagementException。
启用网络接口后，它会使用 EthernetManager.updateConfiguration() 设置的配置。如果 EthernetManager.updateConfiguration() 尚未设置配置，则网络接口会使用资源叠加层 config_ethernet_interfaces，或者，如果没有叠加层，则使用默认以太网网络配置。
要停用网络接口，请调用 EthernetManager.disableInterface()
public final class InterfaceEnabler {
private final Context mApplicationContext;
private final EthernetManager mEthernetManager;
private final OutcomeReceiver<String, EthernetNetworkManagementException> mOutcomeReceiver;
public InterfaceEnabler(Context applicationContext,
OutcomeReceiver<String, EthernetNetworkManagementException> outcomeReceiver) {
mApplicationContext = applicationContext;
mEthernetManager = applicationContext.getSystemService(EthernetManager.class);
mOutcomeReceiver = outcomeReceiver;
}
public void disableInterface(String ifaceName) {
mEthernetManager.disableInterface(ifaceName,
mApplicationContext.getMainExecutor(),
mOutcomeReceiver);
}
}
关于代码的要点
ifaceName是要停用的网络接口的名称。getMainExecutor()返回应用上下文。OutcomeReceiver是一个回调，用于传递完成情况，成功时返回更新后的网络名称，出错时返回EthernetNetworkManagementException。
更新网络配置
要更新以太网网络配置，请调用 EthernetManager.updateConfiguration()
public final class ConfigurationUpdater {
private final Context mApplicationContext;
private final EthernetManager mEthernetManager;
private final OutcomeReceiver<String, EthernetNetworkManagementException> mCallback;
public ConfigurationUpdater(Context applicationContext,
OutcomeReceiver<String, EthernetNetworkManagementException> callback) {
mApplicationContext = applicationContext;
mEthernetManager = applicationContext.getSystemService(EthernetManager.class);
mCallback = callback;
}
public void updateNetworkConfiguration(String packageNames,
String ipConfigurationText,
String networkCapabilitiesText,
String interfaceName)
throws IllegalArgumentException, PackageManager.NameNotFoundException {
EthernetNetworkUpdateRequest request = new EthernetNetworkUpdateRequest.Builder()
.setIpConfiguration(getIpConfiguration(ipConfigurationText))
.setNetworkCapabilities(getCapabilities(
interfaceName, networkCapabilitiesText, packageNames))
.build();
mEthernetManager.updateConfiguration(interfaceName, request,
mApplicationContext.getMainExecutor(), mCallback);
}
}
关于代码的要点
getCapabilities()是一个辅助方法，用于获取当前网络功能并调用convertToUIDs()以将人类可读的软件包名称转换为 Linux唯一标识符 (UID)。通常，您事先不知道与其关联软件包的 UID。因此，如果您想使用EthernetManager.updateConfiguration()限制对应用子集的访问权限，则需要使用其 UID。request是将用于内部网络的配置。请求可以包含 IP 配置和网络功能的新设置。如果网络已在连接堆栈中注册，则会根据配置进行更新。此配置不会跨重启持久存在。getMainExecutor()返回在其上调用侦听器的执行程序。mCallback是一个回调，用于传递完成情况，成功时返回更新后的网络名称，出错时返回EthernetNetworkManagementException。
updateConfiguration() 可能会更新 Android 连接堆栈视为不可变的网络特性。网络会关闭、更新，然后再重新启动，以更新这些不可变属性。
将网络限制为应用的子集
您可以使用 EthernetManager#updateConfiguration 将访问权限限制为仅允许的 UID 的子集。使用此方法来涵盖需要此功能的用例，例如仅可供少量 OEM 应用使用的内部车载网络。
Android 主要通过 UID 跟踪应用。以下来自 UIDToPackageNameConverter.java 的代码显示了如何从软件包名称字符串中获取一系列 UID
public static Set<Integer> convertToUids(Context applicationContext, String packageNames)
throws PackageManager.NameNotFoundException {
final PackageManager packageManager = applicationContext.getPackageManager();
final UserManager userManager = applicationContext.getSystemService(UserManager.class);
final Set<Integer> uids = new ArraySet<>();
final List<UserHandle> users = userManager.getUserHandles(true);
String[] packageNamesArray = packageNames.split(",");
for (String packageName : packageNamesArray) {
boolean nameNotFound = true;
packageName = packageName.trim();
for (final UserHandle user : users) {
try {
final int uid =
packageManager.getApplicationInfoAsUser(packageName, 0, user).uid;
uids.add(uid);
nameNotFound = false;
} catch (PackageManager.NameNotFoundException e) {
// Although this may seem like an error scenario, it is OK as all packages are
// not expected to be installed for all users.
continue;
}
}
if (nameNotFound) {
throw new PackageManager.NameNotFoundException("Not installed: " + packageName);
}
}
return uids;
关于代码的要点
getApplicationInfoAsuser().uid用于检索来自软件包名称的 UID。uids是生成的整数数组。
以下 EthernetManagerTest.kt 中的代码显示了如何使用允许使用网络的应用的 UID 更新网络接口配置
val allowedUids = setOf(Process.myUid())
val nc = NetworkCapabilities.Builder(request.networkCapabilities)
.setAllowedUids(allowedUids).build()
updateConfiguration(iface, capabilities = nc).expectResult(iface.name)
关于代码的要点
allowUids是允许使用网络的已允许应用 UID 集。updateConfiguration()更新配置以将网络限制为提供的 UID 集。