Skip to content

Latest commit

 

History

History
185 lines (132 loc) · 5.31 KB

README.md

File metadata and controls

185 lines (132 loc) · 5.31 KB
Raw

注意！！！

develop 才是最新的代码，同步自原作者的 develop 分支，但似乎该分支有点问题，所有依旧采用主分支.

flutter_openvpn

A new Flutter plugin that uses OpenVpn.

Installation

  1. Depend on it Add this to your package's pubspec.yaml file:
dependencies:
  flutter_openvpn: ^0.2.0
  1. Install it You can install packages from the command line:

with Flutter:

$ flutter pub get

Alternatively, your editor might support flutter pub get. Check the docs for your editor to learn more.

  1. Import it Now in your Dart code, you can use:
import 'package:flutter_openvpn/flutter_openvpn.dart';

Supported Platforms

  • 22 >= Android
  • 9.0 >= iOS

Build project first

  • After adding package to pubspec.yaml, Run build command
flutter build apk --debug //for android
flutter build ios --no-codesign //for ios

Ignore any build errors.

Android integration

  • Change minimum sdk to 22 :
  1. Open Your project in Android Studio.
  2. Open your MainActivity.java(or .kt for kotlin) file (Located in android/app/src/main/YOUR_PACKAGE_NAME/MainActivity)
  3. Override onActivityResult in your activity and add this code to function body
if (requestCode == 1) {
    if (resultCode == RESULT_OK) {
        FlutterOpenvpnPlugin.setPermission(true);
    } else {
        FlutterOpenvpnPlugin.setPermission(false);
    }
}
  1. Finally import FlutterOpenVpn with this import statement
import com.topfreelancerdeveloper.flutter_openvpn.FlutterOpenvpnPlugin;

iOS integration

  • Add VPN Entitlements
  1. Open ios/Runner.xcworkspace in xcode
  2. In Runner target -> Signing & Capabalities -> Click on "+ Capabality" button
  3. Add both "Network Extension" and "App Groups" capabalities
  4. Select ONLY "Packet Tunnel" form newly created Network Extension menu.
  5. Make sure your Bundle identifier is checked in App Groups.
  6. View This Screenshot for visual Guide
  • Add Network Extension Target
  1. Below Runner target click on "+" button to add new target
  2. Search for "Network Extension" in newly opened page and click on next
  3. Give it a name(Without space) and make sure to select Swift as Language and Packet Tunnel as Provider Type.
  4. Click on finish and agree to any message relating to "Activating Extension"
  5. Repeat "Add VPN Entitlements" for newly created target as well
  6. View This Screenshot for visual Guide
  • Change minimum platform target to iOS 9.0 :
  1. In Runner target -> Deployment Info -> change Target to iOS 9.0
  2. Repeat step 2 for your VPN Extension Target as well
  1. Open ios/PodFile
  2. Change your PodFile according to this:
	.
	.
	.
target 'Runner' do
  use_frameworks!
  use_modular_headers!

  flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__))
end

//Add this part
target 'YOUR_TARGET_EXTENSION_NAME' do
  use_frameworks!
  use_modular_headers!
  pod 'OpenVPNAdapter', :git => 'https://github.com/ss-abramchuk/OpenVPNAdapter.git', :tag => '0.7.0'
end
	.
	.
	.
  1. Run 'pod install' command in /ios directory
  • Disable Bitcode
  1. In Vpn Extension Target -> Build Settings
  2. Search for "Bitcode" and set it to NO
  • Add code to PacketTunnelProvider
  1. Open VPNExtension folder/PacketTunnelProvider.swift in xcode.
  2. Replace all code with this and save

Dart/Flutter integration

  • Initilize plugin
FlutterOpenvpn.init(
          localizedDescription: "ExampleVPN", //this is required only on iOS
          providerBundleIdentifier: "com.topfreelancerdeveloper.flutterOpenvpnExample.RunnerExtension",//this is required only on iOS
	  //localizedDescription is the name of your VPN profile
	  //providerBundleIdentifier is the bundle id of your vpn extension
)
/* returns {"currentStatus" : "VPN_CURRENT_STATUS",
	   "expireAt" : "VPN_EXPIRE_DATE_STRING_IN_FORMAT(yyyy-MM-dd HH:mm:ss)",} if successful
 returns null if failed
*/

View this for more info on VPN status Strings

  • Add VPN Profile and connect
FlutterOpenvpn.lunchVpn(
          ovpnFileContent, //content of your .ovpn file
          (isProfileLoaded) => print('isProfileLoaded : $isProfileLoaded'),
          (newVpnStatus) => print('vpnActivated : $newVpnStatus'),
          expireAt: DateTime.now().add(Duration(seconds: 30)),
	  //(Optional) VPN automatically disconnects in next 30 seconds
         )

Publishing to Play Store and App Store

Android

. Recently I discovered an issue with plugin not working with appbundles . If you want to publish to play store use apks . view this issue to stay updated on the matter

iOS

. View Apple Guidelines Relating to VPN . This plugin DOES use Encryption BUT, It uses Exempt Encryptions