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 threading
app = 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 = True
server_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_templateimport webview# Create the Flask appapp = Flask(__name__, static_folder='./assets', template_folder='./templates')# Define a route for the main [email protected]('/')def index(): return render_template('index.html')# Create a Flask server and a pywebview windowif __name__ == '__main__': # Create a pywebview window with the Flask server webview.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 webview
webview.create_window('Woah dude!', html='<h1>Woah dude!<h1>')
webview.start()
版权归原作者 lanfordxb 所有, 如有侵权,请联系我们删除。