Added useTransparentBackground feature for Add2App use cases

.gitignore

@@ -1,6 +1,7 @@
 .DS_Store
 .atom/
 .idea
+.vscode
 .packages
 .pub/
 build/
@@ -9,3 +10,8 @@ packages
 pubspec.lock
 
 example/ios/Podfile.lock
+**/Flutter/App.framework/
+**/Flutter/Flutter.framework/
+**/Flutter/Generated.xcconfig/
+**/Flutter/flutter_assets/
+

CHANGELOG.md

@@ -1,3 +1,87 @@
+# 0.3.1
+
+- Added `useTransparentBackground` feature for Add2App use cases when the native WebView appears behind the Scaffold
+
+# 0.3.0
+
+- Fixes rect capture issue. Ensures WebView remains in the correct place on screen even when keyboard appears.
+- Fixed iOS crash issue with Flutter `>= 0.10.2`.
+- Added new `clearCookies` feature.
+- Added support for `hidden` and `initialChild` feature to show page loading view.
+- Added supportMultipleWindows: enables Multiple Window Support on Android.
+- Added appCacheEnabled: enables Application Caches API on Android.
+- Added allowFileURLs: allows `file://` local file URLs.
+- iOS Now supports: `reload`, `goBack`, and `goForward`.
+- iOS Bug fix `didFailNavigation` #77
+- Updated Android `compileSdkVersion` to `27` matching offical Flutter plugins.
+- Fixed Android `reloadUrl` so settings are not cleared.
+- Enabled compatible `Mixed Content Mode` on Android.
+
+# 0.2.1
+
+- Added webview scrolling listener
+- Added stopLoading() method
+
+# 0.2.0
+
+- update sdk
+- prevent negative webview height in scaffold
+- handle type error in getCookies
+- Support file upload via WebView on Android
+- fix WebviewScaffold crash on iOS
+- Scrollbar functionality to Web view
+- Add support of HTTP errors
+- Add headers when loading url
+
+# 0.1.6
+
+- fix onStateChanged
+- Taking safe areas into account for bottom bars
+- iOS
+    + withLocalUrl option for iOS > 9.0
+- Android
+    + add reload, goBack and foForward function
+
+# 0.1.5
+
+- iOS use WKWebView instead of UIWebView
+
+# 0.1.4
+
+- support localstorage for ANDROID
+
+# 0.1.3
+
+- support zoom in webview
+
+# 0.1.2
+
+- support bottomNavigationBar and persistentFooterButtons on webview scaffold
+
+# 0.1.1
+- support back button navigation for Android
+    + if cannot go back, it will trigger onDestroy
+- support preview dart2
+
+# 0.1.0+1
+
+- fix Android close webview
+
+# 0.1.0
+
+- iOS && Android:
+    - get cookies
+    - eval javascript
+    - user agent setting
+    - state change event
+    - embed in rectangle or fullscreen if null
+    - hidden webview
+
+- Android
+    - adding Activity in manifest is not needed anymore
+
+- Add `WebviewScaffold`
+
 # 0.0.9
 
 - Android: remove the need to use FlutterActivity as base activity

LICENSE

@@ -1,4 +1,4 @@
-// Copyright 2017 Your Company. All rights reserved.
+// Copyright 2017 Hadrien Lejard. All rights reserved.
 //
 // Redistribution and use in source and binary forms, with or without
 // modification, are permitted provided that the following conditions are
@@ -10,7 +10,7 @@
 // copyright notice, this list of conditions and the following disclaimer
 // in the documentation and/or other materials provided with the
 // distribution.
-//    * Neither the name of Your Company nor the names of its
+//    * Neither the name of Hadrien Lejard nor the names of its
 // contributors may be used to endorse or promote products derived from
 // this software without specific prior written permission.
 //

README.md

@@ -1,58 +1,209 @@
-# flutter_webview_plugin
+<img src="https://img.shields.io/badge/Flutter%20Communityflutter__webview__plugin-blue.svg?style=for-the-badge&logo=data:image/png;base64,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" width="800">
 
-Plugin that allow Flutter to communicate with a native WebView.
+[Flutter Community](https://github.com/fluttercommunity/community)
 
-***For Android, it will launch a new Activity inside the App with the Webview inside. Does not allow to integrate a Webview inside a Flutter Widget***
+# Flutter WebView Plugin
 
-***For IOS, it will launch a new UIViewController inside the App with the UIWebView inside. Does not allow to integrate a Webview inside a Flutter Widget***
+[![pub package](https://img.shields.io/pub/v/flutter_webview_plugin.svg)](https://pub.dartlang.org/packages/flutter_webview_plugin)
 
- - [x] Android
- - [x] IOS
+Plugin that allows Flutter to communicate with a native WebView.
+
+**_Warning:_**
+The webview is not integrated in the widget tree, it is a native view on top of the flutter view.
+you won't be able to use snackbars, dialogs ...
 
 ## Getting Started
 
 For help getting started with Flutter, view our online [documentation](http://flutter.io/).
 
 ### How it works
 
-#### Launch WebView with variable url
+#### Launch WebView Fullscreen with Flutter navigation
+
+```dart
+new MaterialApp(
+      routes: {
+        "/": (_) => new WebviewScaffold(
+          url: "https://www.google.com",
+          appBar: new AppBar(
+            title: new Text("Widget webview"),
+          ),
+        ),
+      },
+    );
+```
+
+Optional parameters `hidden` and `initialChild` are available so that you can show something else while waiting for the page to load.
+If you set `hidden` to true it will show a default CircularProgressIndicator. If you additionally specify a Widget for initialChild
+you can have it display whatever you like till page-load.
+
+e.g. The following will show a read screen with the text 'waiting.....'.
+```dart
+return new MaterialApp(
+  title: 'Flutter WebView Demo',
+  theme: new ThemeData(
+    primarySwatch: Colors.blue,
+  ),
+  routes: {
+    '/': (_) => const MyHomePage(title: 'Flutter WebView Demo'),
+    '/widget': (_) => new WebviewScaffold(
+      url: selectedUrl,
+      appBar: new AppBar(
+        title: const Text('Widget webview'),
+      ),
+      withZoom: true,
+      withLocalStorage: true,
+      hidden: true,
+      initialChild: Container(
+        color: Colors.redAccent,
+        child: const Center(
+          child: Text('Waiting.....'),
+        ),
+      ),
+    ),
+  },
+);
+```
+
+`FlutterWebviewPlugin` provide a singleton instance linked to one unique webview,
+so you can take control of the webview from anywhere in the app
+
+listen for events
+
+```dart
+final flutterWebviewPlugin = new FlutterWebviewPlugin();
+
+flutterWebviewPlugin.onUrlChanged.listen((String url) {
+
+});
+```
+
+#### Listen for scroll event in webview
+
+```dart
+final flutterWebviewPlugin = new FlutterWebviewPlugin();
+flutterWebviewPlugin.onScrollYChanged.listen((double offsetY) { // latest offset value in vertical scroll
+  // compare vertical scroll changes here with old value
+});
+
+flutterWebviewPlugin.onScrollXChanged.listen((double offsetX) { // latest offset value in horizontal scroll
+  // compare horizontal scroll changes here with old value
+});
+
+````
+
+Note: Do note there is a slight difference is scroll distance between ios and android. Android scroll value difference tends to be larger than ios devices.
+
+
+#### Hidden WebView
+
+```dart
+final flutterWebviewPlugin = new FlutterWebviewPlugin();
+
+flutterWebviewPlugin.launch(url, hidden: true);
+```
+
+#### Close launched WebView
+
+```dart
+flutterWebviewPlugin.close();
+```
+
+#### Webview inside custom Rectangle
+
+```dart
+final flutterWebviewPlugin = new FlutterWebviewPlugin();
+
+flutterWebviewPlugin.launch(url,
+  fullScreen: false,
+  rect: new Rect.fromLTWH(
+    0.0,
+    0.0,
+    MediaQuery.of(context).size.width,
+    300.0,
+  ),
+);
+```
+
+### Webview Events
+
+- `Stream<Null>` onDestroy
+- `Stream<String>` onUrlChanged
+- `Stream<WebViewStateChanged>` onStateChanged
+- `Stream<double>` onScrollXChanged
+- `Stream<double>` onScrollYChanged
+- `Stream<String>` onError
+
+**_Don't forget to dispose webview_**
+`flutterWebviewPlugin.dispose()`
+
+### Webview Functions
 
 ```dart
-void launchWebView(String url) sync {
-  var flutterWebviewPlugin = new FlutterWebviewPlugin();  
-
-  flutterWebviewPlugin.launch(url);  
-
-  // Wait in this async function until destroy of WebView.
-  await flutterWebviewPlugin.onDestroy.first;
-}
+Future<Null> launch(String url, {
+   Map<String, String> headers: null,
+   bool withJavascript: true,
+   bool clearCache: false,
+   bool clearCookies: false,
+   bool hidden: false,
+   bool enableAppScheme: true,
+   Rect rect: null,
+   String userAgent: null,
+   bool withZoom: false,
+   bool withLocalStorage: true,
+   bool withLocalUrl: true,
+   bool scrollBar: true,
+   bool supportMultipleWindows: false,
+   bool appCacheEnabled: false,
+   bool allowFileURLs: false,
+});
 ```
 
-### Close launched WebView
+```dart
+Future<String> evalJavascript(String code);
+```
 
 ```dart
-void launchWebViewAndCloseAfterWhile(String url) {
-  var flutterWebviewPlugin = new FlutterWebviewPlugin();  
-
-  flutterWebviewPlugin.launch(url);  
-
-  // After 10 seconds.
-  new Timer(const Duration(seconds: 10), () {
-    // Close WebView.
-    // This will also emit the onDestroy event.
-    flutterWebviewPlugin.close();
-  });
-}
+Future<Map<String, dynamic>> getCookies();
 ```
 
-### Android
+```dart
+Future<Null> cleanCookies();
+```
+
+```dart
+Future<Null> resize(Rect rect);
+```
 
-Add the Activity to you `AndroidManifest.xml`:
+```dart
+Future<Null> show();
+```
 
-```xml
-<activity android:name="com.flutter_webview_plugin.WebviewActivity" android:parentActivityName=".MainActivity"/>
+```dart
+Future<Null> hide();
 ```
 
-### iOS
+```dart
+Future<Null> reloadUrl(String url);
+```
+
+```dart
+Future<Null> close();
+```
+
+```dart
+Future<Null> reload();
+```
+
+```dart
+Future<Null> goBack();
+```
+
+```dart
+Future<Null> goForward();
+```
+
+```dart
+Future<Null> stopLoading();
+```
 
-No extra configuration is needed.