1. なぜEthernetManagerのリフレクションが必要なのか

Androidデバイス、特に産業用タブレット、セルフサービス端末、スマートゲートウェイなどの開発において、IPアドレスをプログラムから設定するという課題は多くの開発者に直面されています。Androidシステムの設定には「イーサネット」メニューがあり、手動での設定は可能ですが、大量のデバイスをリモートで管理する場合、手動設定は非現実的です。

Android SDKでは、イーサネットの操作に使用されるandroid.net.EthernetManagerクラスが非公開（@hide）としてマークされています。このため、通常のAPIとして直接呼び出すことはできません。このような制約を克服するために、Javaのリフレクション機能が有効な手段となります。

2. 基本概念と準備

2.1 リフレクション操作対象のクラス

イーサネット設定を行う際には、いくつかの核心クラスを理解する必要があります：

• IpConfiguration: ネットワーク設定のコンテナ。IP割り当て方式（静的または動的）やプロキシ設定を定義します。
• StaticIpConfiguration: 静的IP設定の場合に使用される具体的な情報（IPアドレス、ゲートウェイ、DNSなど）を保持します。
• LinkAddress: IPアドレスとサブネットマスクの組み合わせを表します。
• IpAssignmentとProxySettings: IP割り当て戦略とプロキシ設定戦略を表す列挙型です。

2.2 環境と権限の準備

実装を開始する前に、以下の条件を満たしていることを確認してください：

• Androidバージョン: Android 5.0 (API 21) 以降で動作します。
• システム権限: 通常はシステムアプリとしてインストールするか、システムイメージに署名する必要があります。
• ネットワーク権限: AndroidManifest.xmlに以下の権限を追加します：

  <uses-permission android:name="android.permission.INTERNET" />
  <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

3. 実践：リフレクションによるネットワーク設定

3.1 基本的なツールクラスの実装

まず、動的IP（DHCP）設定から始めましょう。以下に基本的なツールクラスの実装例を示します：

/**
 * イーサネット設定ユーティリティクラス（リフレクションによる非公開API呼び出し）
 * 注意：システムアプリ権限が必要です
 */
public class NetworkConfigurator {

    private static final String ETHERNET_MANAGER_CLASS = "android.net.EthernetManager";
    private static final String IP_CONFIGURATION_CLASS = "android.net.IpConfiguration";
    private static final String STATIC_IP_CONFIGURATION_CLASS = "android.net.StaticIpConfiguration";
    private static final String LINK_ADDRESS_CLASS = "android.net.LinkAddress";
    private static final String IP_ASSIGNMENT_CLASS = "android.net.IpAssignment";
    private static final String PROXY_SETTINGS_CLASS = "android.net.ProxySettings";
    
    /**
     * イーサネットを動的IP（DHCP）で設定
     * @param context コンテキスト
     * @return 設定が成功したかどうか
     */
    public static boolean configureDynamicIp(Context context) {
        try {
            // EthernetManagerクラスの取得
            Class ethernetManagerClass = Class.forName(ETHERNET_MANAGER_CLASS);
            Method getServiceMethod = ethernetManagerClass.getMethod("getService", Context.class);
            Object ethernetManager = getServiceMethod.invoke(null, context);
            
            // IpConfigurationオブジェクトの作成
            Class ipConfigurationClass = Class.forName(IP_CONFIGURATION_CLASS);
            Object ipConfiguration = ipConfigurationClass.newInstance();
            
            // IP割り当て方式をDHCPに設定
            Class ipAssignmentClass = Class.forName(IP_ASSIGNMENT_CLASS);
            Object dhcpAssignment = Enum.valueOf(ipAssignmentClass, "DHCP");
            Field ipAssignmentField = ipConfigurationClass.getDeclaredField("ipAssignment");
            ipAssignmentField.setAccessible(true);
            ipAssignmentField.set(ipConfiguration, dhcpAssignment);
            
            // プロキシ設定をNONEに設定
            Class proxySettingsClass = Class.forName(PROXY_SETTINGS_CLASS);
            Object noProxy = Enum.valueOf(proxySettingsClass, "NONE");
            Field proxySettingsField = ipConfigurationClass.getDeclaredField("proxySettings");
            proxySettingsField.setAccessible(true);
            proxySettingsField.set(ipConfiguration, noProxy);
            
            // 設定を適用
            Method setConfigurationMethod = ethernetManagerClass.getMethod(
                "setConfiguration", ipConfigurationClass);
            setConfigurationMethod.invoke(ethernetManager, ipConfiguration);
            
            return true;
        } catch (Exception e) {
            Log.e("NetworkConfigurator", "動的IP設定に失敗", e);
            return false;
        }
    }
}

3.2 静的IP設定の実装

次に、静的IP設定の実装方法を見ていきましょう。静的IP設定では、IPアドレス、ゲートウェイ、DNSサーバーなどの情報を明示的に指定する必要があります：

/**
 * イーサネットを静的IPで設定
 * @param context コンテキスト
 * @param ipAddress IPアドレス（例："192.168.1.100"）
 * @param subnetMask サブネットマスク（例："255.255.255.0"）
 * @param gateway ゲートウェイ（例："192.168.1.1"）
 * @param dnsServers DNSサーバーリスト（例：new String[]{"8.8.8.8", "8.8.4.4"}）
 * @return 設定が成功したかどうか
 */
public static boolean configureStaticIp(Context context, String ipAddress, String subnetMask, 
                                      String gateway, String[] dnsServers) {
    try {
        // EthernetManagerクラスの取得
        Class ethernetManagerClass = Class.forName(ETHERNET_MANAGER_CLASS);
        Method getServiceMethod = ethernetManagerClass.getMethod("getService", Context.class);
        Object ethernetManager = getServiceMethod.invoke(null, context);
        
        // IpConfigurationオブジェクトの作成
        Class ipConfigurationClass = Class.forName(IP_CONFIGURATION_CLASS);
        Object ipConfiguration = ipConfigurationClass.newInstance();
        
        // IP割り当て方式をSTATICに設定
        Class ipAssignmentClass = Class.forName(IP_ASSIGNMENT_CLASS);
        Object staticAssignment = Enum.valueOf(ipAssignmentClass, "STATIC");
        Field ipAssignmentField = ipConfigurationClass.getDeclaredField("ipAssignment");
        ipAssignmentField.setAccessible(true);
        ipAssignmentField.set(ipConfiguration, staticAssignment);
        
        // StaticIpConfigurationオブジェクトの作成
        Class staticIpConfigClass = Class.forName(STATIC_IP_CONFIGURATION_CLASS);
        Object staticIpConfig = staticIpConfigClass.newInstance();
        
        // LinkAddressオブジェクトの作成
        Class linkAddressClass = Class.forName(LINK_ADDRESS_CLASS);
        Constructor linkAddressConstructor = linkAddressClass.getConstructor(
            InetAddress.class, int.class);
        InetAddress inetAddress = InetAddress.getByName(ipAddress);
        int prefixLength = calculatePrefixLength(subnetMask);
        Object linkAddress = linkAddressConstructor.newInstance(inetAddress, prefixLength);
        
        // StaticIpConfigurationにIPアドレスを設定
        Field ipAddressField = staticIpConfigClass.getDeclaredField("ipAddress");
        ipAddressField.setAccessible(true);
        ipAddressField.set(staticIpConfig, linkAddress);
        
        // ゲートウェイの設定
        if (gateway != null && !gateway.isEmpty()) {
            InetAddress gatewayAddress = InetAddress.getByName(gateway);
            Field gatewayField = staticIpConfigClass.getDeclaredField("gateway");
            gatewayField.setAccessible(true);
            gatewayField.set(staticIpConfig, gatewayAddress);
        }
        
        // DNSサーバーの設定
        if (dnsServers != null && dnsServers.length > 0) {
            InetAddress[] dnsAddresses = new InetAddress[dnsServers.length];
            for (int i = 0; i < dnsServers.length; i++) {
                dnsAddresses[i] = InetAddress.getByName(dnsServers[i]);
            }
            Field dnsServersField = staticIpConfigClass.getDeclaredField("dnsServers");
            dnsServersField.setAccessible(true);
            dnsServersField.set(staticIpConfig, Arrays.asList(dnsAddresses));
        }
        
        // IpConfigurationにStaticIpConfigurationを設定
        Field staticIpField = ipConfigurationClass.getDeclaredField("staticIpConfiguration");
        staticIpField.setAccessible(true);
        staticIpField.set(ipConfiguration, staticIpConfig);
        
        // 設定を適用
        Method setConfigurationMethod = ethernetManagerClass.getMethod(
            "setConfiguration", ipConfigurationClass);
        setConfigurationMethod.invoke(ethernetManager, ipConfiguration);
        
        return true;
    } catch (Exception e) {
        Log.e("NetworkConfigurator", "静的IP設定に失敗", e);
        return false;
    }
}

/**
 * サブネットマスクからプレフィックス長を計算
 * @param subnetMask サブネットマスク（例："255.255.255.0"）
 * @return プレフィックス長（例：24）
 */
private static int calculatePrefixLength(String subnetMask) {
    if (subnetMask == null) {
        return 24; // デフォルト値
    }
    
    String[] parts = subnetMask.split("\\.");
    if (parts.length != 4) {
        return 24; // デフォルト値
    }
    
    int prefixLength = 0;
    for (String part : parts) {
        int octet = Integer.parseInt(part);
        String binaryString = Integer.toBinaryString(octet);
        prefixLength += binaryString.chars().filter(c -> c == '1').count();
    }
    
    return prefixLength;
}

3.3 使用例

以下に、上記のツールクラスを使用する例を示します：

// アクティビティ内での使用例
public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        
        // 動的IP設定
        boolean dynamicResult = NetworkConfigurator.configureDynamicIp(this);
        Log.d("MainActivity", "動的IP設定結果: " + dynamicResult);
        
        // 静的IP設定
        String ipAddress = "192.168.1.100";
        String subnetMask = "255.255.255.0";
        String gateway = "192.168.1.1";
        String[] dnsServers = new String[]{"8.8.8.8", "8.8.4.4"};
        
        boolean staticResult = NetworkConfigurator.configureStaticIp(
            this, ipAddress, subnetMask, gateway, dnsServers);
        Log.d("MainActivity", "静的IP設定結果: " + staticResult);
    }
}

4. 注意事項とベストプラクティス

リフレクションを使用した非公開APIの呼び出しには、いくつかの重要な注意点があります：

• デバイス依存性: 各デバイスメーカーがAndroidフレームワークを独自にカスタマイズしている可能性があるため、すべてのデバイスで動作するとは限りません。
• 安定性: 非公開APIは将来のAndroidバージョンで変更または削除される可能性があります。コードは常にテストする必要があります。
• 権限: システムアプリ権限が必要であるため、通常のアプリでは機能しません。
• エラーハンドリング: リフレクション操作では、予期しない例外が発生する可能性があるため、堅牢なエラーハンドリングを実装してください。

これらのツールクラスと実装例を参考にすることで、Androidデバイスのイーサネット設定をプログラムから制御する方法を理解できるでしょう。