wifi_binder 0.0.1

A Flutter plugin to **force network traffic over Wi-Fi only**

Berikut adalah isi lengkap README.md untuk plugin Flutter wifi_binder, termasuk deskripsi, setup, penggunaan, dan troubleshooting:

---

📶 wifi_binder

A Flutter plugin to force network traffic over Wi-Fi only, even when mobile data is turned on. Useful for connecting to local-only Wi-Fi devices such as dashcams, IoT devices, or local servers.

🛠 This plugin currently supports Android only, and is written in Kotlin.

---

✨ Features

• ✅ Bind process-level networking to Wi-Fi
• 🔄 Unbind to resume normal routing (use both mobile and Wi-Fi)
• ⚡ Works without turning off mobile data manually
• 🛑 Android only (iOS not supported)

---

🚀 Getting Started

1. Add the Plugin to Your Project

Download or clone this repository and place it inside a packages/ directory, or any location in your project.

Update your pubspec.yaml:

dependencies:
  wifi_binder:
    path: ./packages/wifi_binder

---

2. Import and Use in Code

import 'package:wifi_binder/wifi_binder.dart';

/// Forces all traffic through the currently connected Wi-Fi
await WifiBinder.bindWifiOnly();

/// Unbinds the network and restores default behavior
await WifiBinder.unbindNetwork();

---

📱 Android Setup

1. Permissions

In your AndroidManifest.xml (usually under android/app/src/main/), add:

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

2. Minimum SDK

In android/app/build.gradle, set:

minSdkVersion 23

---

✅ Example Use Case

If you're building a dashcam viewer app:

• The app connects to dashcam Wi-Fi (e.g., 192.168.0.1)
• Mobile data is still ON (by default Android routes requests via mobile)
• With this plugin, your video stream or requests are forced to use Wi-Fi

---

❗ Limitations

• 🔸 Android only
• 🔸 Not intended for background tasks or multi-process routing
• 🔸 May not work if user switches Wi-Fi after binding (call bindWifiOnly() again)
• ⚠️ Ensure the Wi-Fi connection is already established before calling bind

---

🧪 Testing

Use on a real Android device connected to a Wi-Fi network with no internet access (e.g., dashcam hotspot). Ensure mobile data is active to validate that the plugin correctly routes over Wi-Fi.

---

🔧 Troubleshooting

Problem	Solution
Network still using mobile data	Ensure bindWifiOnly() is called after Wi-Fi is connected
setProcessDefaultNetwork deprecated	The plugin uses bindProcessToNetwork automatically for Android ≥ 23
iOS not supported	iOS doesn’t allow custom network binding at this level
App crash on start	Check minSdkVersion >= 23 and permissions are granted

---

📂 Plugin Structure

wifi_binder/
├── lib/
│   └── wifi_binder.dart
├── android/
│   └── src/main/kotlin/... (Kotlin logic)
├── pubspec.yaml
└── README.md

---

📜 License

This project is licensed under the MIT License.

---

Jika kamu ingin README ini dalam Bahasa Indonesia atau ingin dipublikasikan ke pub.dev, tinggal beri tahu saja.