# android-ethernet-adapter

**Repository Path**: android-third-party-project/android-ethernet-adapter

## Basic Information

- **Project Name**: android-ethernet-adapter
- **Description**: No description available
- **Primary Language**: Java
- **License**: GPL-3.0
- **Default Branch**: phase1
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-03-05
- **Last Updated**: 2024-03-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

Android Ethernet Adapter
============

![Logo](https://raw.githubusercontent.com/kopihao/android-ethernet-adapter/phase1/photoshop/android-ethernet-adapter-logo.png)

# What's good?
#### Convenient way to access android.net.EthernetManager that is a hidden Native Android API without complex Android SDK setup.

#### Java reflections work behind the scene.

### Minimal methods to get things work

* Provides various EthernetManager.class methods:
    1) boolean isSupported();
    2) boolean isEthEnabled();
    3) void setEthEnabled(boolean enable);
    4) void updateEthDevInfo(boolean dhcp, String ip, String gateway, String subnetmask, String dns);
    5) EthernetConfig getSavedEthConfig(); 

* EthernetConfig value:
    1) `dev_name`
    2) `ipaddr`
    3) `netmask`
    4) `routeAddr`
    5) `dns`
    6) `mode`

* Get new instance simply by:
```java
EthernetAdapter ethernetAdapter = new EthernetAdapter(getApplicationContext()); 
```

### Warning
* Android Ethernet only works with [signed application with the system signature][4]
* Requires declaration of android:sharedUserId="android.uid.system in AndroidManifest.xml
* Requires signingConfig in build.gradle of application

Demostration
--------  

![Preview](https://github.com/kopihao/android-ethernet-adapter/blob/phase1/website/static/demo_preview.gif)

##### __Please checkout [source code][3]__

Add to your Android project
--------
<img src="https://img.shields.io/bintray/v/kopihao/maven/android-ethernet-adapter.svg"> <img src="https://img.shields.io/maven-central/v/com.github.kopihao/android-ethernet-adapter.svg">

```gradle
dependencies {
  implementation 'com.github.kopihao:android-ethernet-adapter:1.0.1'
} 
```

More Information
-------- 
##### For documentation and additional information please visit [official website][1]. 
##### For enquiries and solutions please visit [stackoverflow][2].

License
-------

    Licensed under the GNU General Public License v3.0 (the "License");
    Copyright 2013 Kopihao.MY

 [1]: https://github.com/kopihao/android-ethernet-adapter/
 [2]: https://stackoverflow.com/questions/tagged/android-ethernet-adapter?sort=frequent
 [3]: https://github.com/kopihao/android-ethernet-adapter/blob/phase1/demo/src/main/java/com/kopirealm/androidethernetadapter/demo/MainActivity.java
 [4]: https://stackoverflow.com/questions/37586255/signing-my-android-application-as-system-app