Initial commit.

Author: jchv

LICENSE.md

@@ -0,0 +1,7 @@
+# ISC License
+
+Copyright © 2021, John Chadwick <[email protected]>
+
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

README.md

@@ -0,0 +1,6 @@
+# Go Webview Selector
+This library is a tiny shim that provides access to a native webview for a given platform. It selects between two implementations:
+
+* On Windows, [go-webview2](https://github.com/jchv/go-webview2) will be chosen. It embeds a copy of WebView2Loader, so it should work out of the box on any setup that has the WebView 2 runtime installed, which should include up-to-date Windows 10 installations and Windows 11. (As well, WebView 2 runtime is available going backwards to Windows 7.) This library does not require CGo and thus will build and run with `CGO_ENABLED=0`.
+
+* On other operating systems, [webview/webview](https://github.com/webview/webview) will be used. This runtime requires CGo, but supports a wide variety of platforms.

cmd/demo/main.go

@@ -0,0 +1,20 @@
+package main
+
+import (
+	"log"
+
+	"github.com/jchv/go-webview-selector"
+)
+
+func main() {
+	debug := true
+	w := webview.New(debug)
+	if w == nil {
+		log.Fatalln("Failed to load webview.")
+	}
+	defer w.Destroy()
+	w.SetTitle("Minimal webview example")
+	w.SetSize(800, 600, webview.HintFixed)
+	w.Navigate("https://en.m.wikipedia.org/wiki/Main_Page")
+	w.Run()
+}

go.mod

@@ -0,0 +1,5 @@
+module github.com/jchv/go-webview-selector
+
+go 1.16
+
+require github.com/jchv/go-webview2 v0.0.0-20210720204005-cbb937ae0f7f

go.sum

@@ -0,0 +1,7 @@
+github.com/jchv/go-webview2 v0.0.0-20210720204005-cbb937ae0f7f h1:LkvHq825sNdOAkjmr8CNIOG2UR8HrhcLgHAWzPfQy8c=
+github.com/jchv/go-webview2 v0.0.0-20210720204005-cbb937ae0f7f/go.mod h1:TQ8wBGSagb6vuJxuRsQXw5YjLJvC6aXvy/VSXGJK+8E=
+github.com/jchv/go-winloader v0.0.0-20200815041850-dec1ee9a7fd5 h1:pdFFlHXY9tZXmJz+tRSm1DzYEH4ebha7cffmm607bMU=
+github.com/jchv/go-winloader v0.0.0-20200815041850-dec1ee9a7fd5/go.mod h1:alcuEEnZsY1WQsagKhZDsoPCRoOijYqhZvPwLG0kzVs=
+golang.org/x/sys v0.0.0-20200810151505-1b9f1253b3ed/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
+golang.org/x/sys v0.0.0-20200814200057-3d37ad5750ed h1:J22ig1FUekjjkmZUM7pTKixYm8DvrYsvrBZdunYeIuQ=
+golang.org/x/sys v0.0.0-20200814200057-3d37ad5750ed/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=

shim_other.go

@@ -0,0 +1,37 @@
+// +build !windows
+
+package webview
+
+import (
+	"unsafe"
+
+	"github.com/webview/webview"
+)
+
+type WebView = webview.WebView
+
+type Hint = webview.Hint
+
+const (
+	// HintNone specifies that width and height are default size
+	HintNone Hint = iota
+
+	// HintFixed specifies that window size can not be changed by a user
+	HintFixed
+
+	// HintMin specifies that width and height are minimum bounds
+	HintMin
+
+	// HintMax specifies that width and height are maximum bounds
+	HintMax
+)
+
+// New creates a new webview in a new window.
+func New(debug bool) WebView {
+	return webview.New(debug)
+}
+
+// NewWindow creates a new webview using an existing window.
+func NewWindow(debug bool, window unsafe.Pointer) WebView {
+	return webview.NewWindow(debug, window)
+}

shim_windows.go

@@ -0,0 +1,37 @@
+// +build windows
+
+package webview
+
+import (
+	"unsafe"
+
+	"github.com/jchv/go-webview2"
+)
+
+type WebView = webview2.WebView
+
+type Hint = webview2.Hint
+
+const (
+	// HintNone specifies that width and height are default size
+	HintNone Hint = iota
+
+	// HintFixed specifies that window size can not be changed by a user
+	HintFixed
+
+	// HintMin specifies that width and height are minimum bounds
+	HintMin
+
+	// HintMax specifies that width and height are maximum bounds
+	HintMax
+)
+
+// New creates a new webview in a new window.
+func New(debug bool) WebView {
+	return webview2.New(debug)
+}
+
+// NewWindow creates a new webview using an existing window.
+func NewWindow(debug bool, window unsafe.Pointer) WebView {
+	return webview2.NewWindow(debug, window)
+}