Cloudflare 中文文档
Pages
编辑这个页面
跳转官方原文档
Set theme to dark (⇧+D)

Qwik

Qwik是一个开源的、以 DOM 为中心的、可续写的网络应用程序框架,其设计重点是 可续写性、HTML 的服务器端渲染和代码的 细粒度懒加载,从而尽可能缩短交互时间。

在本指南中,你将通过 Qwik City(Qwik 的元框架)创建一个新的 Qwik 应用程序,并使用 Cloudflare Pages 进行部署。

​​ 创建一个新项目

使用 create-cloudflare CLI (C3) 创建新项目。C3 将创建一个新的项目目录,启动 Qwik 的官方设置工具,并提供即时部署选项。

要使用 create-cloudflare 创建新的 Qwik 项目,请运行以下命令:

create-cloudflare将安装其他依赖项,包括Wrangler CLI和任何必要的适配器,并向你提出设置问题。

作为 cloudflare-pages 适配器安装的一部分,将创建一个 functions/[[path]].ts 文件。文件名[[path]]表示该文件将处理对所有传入 URL 的请求。请参阅 Path segments,了解更多信息。

选择服务器选项后,将目录更改为项目,然后运行以下命令渲染项目:

​​ 在你继续之前

所有框架指南都假定你已经对 Git 有了基本了解。如果你是 Git 的新手,请参考这本 Git 手册摘要,了解如何在本地机器上设置 Git。

如果使用 SSH 克隆,则必须在每台用于从 GitHub 推送或拉取的计算机上 生成 SSH 密钥

更多信息请参阅 GitHub 文档 Git 文档

​​ 创建 GitHub 仓库

访问 repo.new,创建一个新的 GitHub 仓库。创建新仓库后,进入新创建的项目目录,准备并在终端运行以下命令将本地应用程序推送到 GitHub:

​​ 使用 Cloudflare Pages部署

​​ 通过 create-cloudflare CLI (C3) 进行部署

如果使用 create-cloudflare(C3)创建新的 Qwik 项目,C3 将安装项目所需的所有依赖项,并提示你通过 CLI 部署项目。如果你进行了部署,你的网站就会上线,并向你提供一个部署 URL。

​​ 通过 Cloudflare 控制面板部署

  1. 登录 Cloudflare 仪表板 并选择你的账户。
  2. 在账户主页,选择 工作者和页面> 创建应用程序> 页面> 连接到 Git
  3. 选择创建的新 GitHub 仓库,并在 **设置构建和部署**部分提供以下信息:
Configuration option Value
Production branch main
Build command npm run build
Build directory dist

配置好网站后,你就可以开始第一次部署了。你应该会看到 Cloudflare 页面正在安装 npm、你的项目依赖项,并在部署前构建你的网站。

部署网站后,你将在 *.pages.dev上为你的项目收到一个唯一的子域。 每次你向 Qwik 网站提交新代码时,Cloudflare Pages 都会自动重建你的项目并进行部署。你还可以在新的拉取请求中访问 预览部署,以便在将更改部署到生产环境之前预览网站的外观。

​​ 在 Qwik 应用程序中使用绑定

绑定 允许你的应用程序与 Cloudflare 开发人员产品交互,例如 KVDurable ObjectR2 D1

在 QwikCity 中,通过 routeLoaders actions 添加服务器端代码。然后通过框架提供的 platform 对象访问为应用程序设置的绑定。

下面的代码块展示了在 QwikCity 中访问 KV 命名空间的示例。

​​ 了解更多

完成本指南后,你已成功将 Qwik 网站部署到 Cloudflare Pages。要开始使用其他框架,请参阅框架指南列表