pywebview 入门
pywebview 入门
文档地址
地址 https://pywebview.flowrl.com/guide/
一、pywebview 简介
1. 什么是 pywebview？
pywebview 是一个轻量级的 python 库，旨在简化桌面应用程序的开发。它利用系统的 WebView 组件，使得开发人员可以使用现代 Web 技术（HTML、CSS、JavaScript）来创建用户界面，同时使用 python 处理业务逻辑。pywebview 使得创建跨平台桌面应用程序变得更加简单和高效。
2. 主要功能和特点
-
跨平台支持, pywebview 支持 Windows、macOS 和 Linux，确保应用程序可以在多个平台上运行。
-
简易集成,可以轻松地将 Web 应用嵌入到桌面应用中，无需复杂的设置
-
安全性：支持禁用本地文件访问和执行外部脚本，提供额外的安全层。
二、安装使用
1、安装
# 会默认安装基本的依赖 pip install pywebview
2、Mac系统，如果使用的是自己安装的python，需要安装安装下面依赖
pip install pyobjc
3、如果你希望使用 pySide2 作为 GUI 库来创建和管理窗口执行下面的命令
pip install pywebview[qt]
4、pywebview默认使用系统自带的 WebView 组件作为浏览器引擎
-
windows 使用默认使用 Internet Explorer 11 作为 WebView 引擎。
-
macOS 默认使用 WebKit 引擎，这是 macOS 自带的 WebView 组件，基于 Safari 浏览器的引擎。
-
Linux 默认使用 WebKitGTK，这是 Linux 上常用的 WebView 组件，基于 WebKit 引擎
如果需要其他引擎，需要单独安装：
5、windows中使用 CEF（Chromium Embedded Framework）作为引擎
pip install cefpython3
指定backend
import webview
webview.create_window('My App', 'https://www.baidu.com/', backend='cef')
webview.start()
三、使用示例
1、基础使用
# demo1.py
import webview
window = webview.create_window('Woah dude!', 'https://pywebview.flowrl.com')
webview.start()
create_window函数用于创建一个新窗口，并返回一个 window 对象实例。在调用webview.start()之前创建的窗口将在 GUI 循环启动后立即显示。GUI 循环启动后创建的窗口也会立即显示。您可以创建任意数量的窗口，所有已打开的窗口都会按创建顺序存储在webview.windows列表中。
2、同时打开两个窗口
import webview
first_window = webview.create_window('Woah dude!', 'https://pywebview.flowrl.com')
second_window = webview.create_window('Second window', 'https://woot.fi')
webview.start()
3、调用后台执行
webview.start会启动一个 GUI 循环，并阻止进一步的代码执行，直到最后一个窗口被销毁。由于 GUI 循环是阻塞的，您必须在单独的线程或进程中执行后台逻辑。您可以通过将函数传递给webview.start(func, (params,))来执行后台代码。这将启动一个单独的线程，与手动启动线程是相同的。
# 界面打开后就会自动弹窗
import webview
def custom_logic(window):window.toggle_fullscreen()window.evaluate_js('alert("Nice one brother")')
window = webview.create_window('Woah dude!', html='<h1>Woah dude!<h1>')
webview.start(custom_logic, window)
window.evaluate_js可以使用python执行js代码
4、js调用python
import webview# 这里是核心，是和js中交互的关键
class Api():def log(self, value):print(value)webview.create_window("Test", html="<button οnclick='pywebview.api.log(\"Woah dude!\")'>Click me</button>", js_api=Api())
webview.start()
在打开的界面中点击按钮，后台就可以看到log函数被调用，会把传入的值
Woah dude!打印到控制台
5、HTTP Server
pywebview 默认使用 bottlepy 作为http 服务，默认端口是8080，前后服务也可以使用http 通信
-
index.html
<!DOCTYpE html>
<html lang="en">
<head><meta charset="UTF-8"><title>pywebview Example</title>
</head>
<body><h1>pywebview AJAX Example</h1><button οnclick="fetchData()">Fetch Data</button><p id="response"></p><script>function fetchData() {fetch('http://localhost:8080/api/data').then(response => response.json()).then(data => {document.getElementById('response').innerText = data.message;}).catch(error => console.error('Error fetching data:', error));}</script>
</body>
</html>
-
demo.py
import webview
from bottle import Bottle, run, static_file
import threadingapp = Bottle()@app.route("/api/data")
def get_data():return {"message": "Hello from the server!"}@app.route("/")
def index():return static_file("index.html", root=".")# 启动 HTTp 服务器
def start_server():run(app, host="localhost", port=8080)if __name__ == "__main__":# 在单独的线程中启动 HTTp 服务器server_thread = threading.Thread(target=start_server)server_thread.daemon = Trueserver_thread.start()# 创建并启动 pywebview 窗口webview.create_window("pywebview Example", "http://localhost:8080")webview.start()
6、使用其他web框架，比如Flask
-
安装falsk
pip install flask
-
项目结构
project/ ├── app.py ├── assets/ │ └── (your static files like CSS, JS, images, etc.) └── templates/└── index.html
-
app.py
from flask import Flask, render_template import webview# Create the Flask app app = Flask(__name__, static_folder='./assets', template_folder='./templates')# Define a route for the main page @app.route('/') def index():return render_template('index.html')# Create a Flask server and a pywebview window if __name__ == '__main__':# Create a pywebview window with the Flask serverwebview.create_window('Flask example', app)webview.start() -
templates/index.html
<!DOCTYpE html> <html lang="en"> <head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>Flask Example</title> </head> <body><h1>Hello from Flask and pywebview!</h1> </body> </html>
7、指向本地html文件
import webview# this will be served as file:///home/pywebview/project/index.html
webview.create_window('Woah dude!', '/home/pywebview/project/index.html')
webview.start()
8、直接渲染html字符
import webviewwebview.create_window('Woah dude!', html='<h1>Woah dude!<h1>')
webview.start()
