Skip to content

Latest commit

 

History

History
189 lines (135 loc) · 8.77 KB

README.zh.md

File metadata and controls

189 lines (135 loc) · 8.77 KB
Raw
项目图标

F-OH PWA 第三方

Gitee 仓库 GitHub 仓库

PWA Windows Linux

中文 | English | 期待你的翻译！

概览

F-OH 是一个 OpenHarmony 平台上 FOSS（Free and Open Source Software，自由开源软件）的应用中心，并提供下载安装支持。

F-OH PWA 是基于粼光商店 V3 Demo 的一个浏览器版本的跨平台的第三方 F-OH。

F-OH PWA + BrowserCE，通过网页分发开源鸿蒙 hap 应用的最佳实践，对于有内部分发测试 hap 应用的团队来说，是一个不错的选择。

2023-12-29 F-OH 停服公告

许可证 Netlify Status 贡献者公约

开源许可证

QQ 群（开鸿派）: 528608689 电子邮件: jesse205@qq.com

屏幕截图

主页 分类 应用详情
主页 分类 应用详情

特点

  • 设计：多设计语言
  • 平台：浏览器、Linux、Windows
  • 广告：无
  • 资费：暂时没有
  • 源代码：开源到 Gitee、GitHub
  • 国际化：基于 Vue I18n 的多语言

下载与使用

F-OH PWA 提供 独立软件 与 网页访问 两种方式供用户选择。

Tip

因服务器没有 SSL 并且有跨域问题， F-OH PWA 暂时无法使用（无安全上下文，无法满足成为 PWA 的最低要求），请使用 F-OH Tauri 或 F-OH Lite (Web)。 如需使用 PWA，请使用部署在 Netlify 上的开发版。

PWA 安装

渐进式 Web 应用（Progressive Web App，PWA）是一个使用 web 平台技术构建的应用程序，但它提供的用户体验就像一个特定平台的应用程序。（来自 MDN）

部分浏览器支持安装该网站到桌面，只需点击“安装应用”。安装后应用名会从 F-OH Lite 变为 F-OH PWA。

Chrome 安装应用示意图

Note

有关使用 PWA 的更多信息，请参见在 Microsoft Edge 中使用渐进式 Web 应用。

替换 API 地址

默认的 API 地址为 /api，您可以通过三种方式替换该地址。

  1. 修改 .env，将 FOHPWA_URL_API_WEB、FOHPWA_URL_API_WEB_ORIGIN、FOHPWA_URL_API_CLIENT、FOHPWA_URL_API_CLIENT_ORIGIN 替换为您自己的 API 地址后打包并发布。
  2. 直接在应用的“设置”中修改 API 地址。
  3. 在应用的链接中添加 ?apiUrl=<你的API地址>，临时覆盖 API 地址。

系列项目

  • F-OH：F-OH OpenHarmony 移动端
  • F-OH Data：F-OH 所有应用程序的元数据，开发者在这里PR提交自己的应用
  • F-OH Server：F-OH 服务器，提供接口服务、平台管理等（待开发）
  • F-OH Website：F-OH 网站，包含文档、博客、精选应用等（待开发）

项目设置

  1. 安装 NodeJS v21 和 pnpm
  2. （可选，仅当需要开发 Tauri 应用时需要）按照 Tauri 的预先准备设置 Tauri 环境。
    • Windows: Microsoft Visual Studio C++ 生成工具、WebView2、Rust。
    • macOS: CLang 和 macOS 开发依赖项、Rust。
    • Linux: 系统依赖、Rust。
  3. 安装依赖，运行 pnpm install。

为开发编译和热加载

  1. 克隆 F-OH Data 并启动一个服务器。
  2. （可选）将 .env.development.local.example 另存为 .env.development.local，并配置一些变量。
  3. 在该项目打开终端，按照以下规则运行命令。
    • 网页与 PWA 应用：运行 pnpm dev:web。
    • Windows Tauri 软件：运行 pnpm dev:tauri。

为生产编译和精简

  1. 设置 .env.production 文件。
  2. 在该项目打开终端，按照以下规则运行命令。
    • 网页与 PWA 应用：
      1. 运行 pnpm build:web 。
      2. （可选）拉取 F-OH Data 到 dist/data。
      3. 部署 dist/* 到服务器。
    • Windows Tauri 软件：
      1. 运行 pnpm build:tauri。
      2. 发布 src-tauri\target\release\F-OH Tauri.exe 与 src-tauri\target\release\bundle\nsis\F-OH Tauri_<version>_x64-setup.exe。

约束和修复文件

yarn lint-fix
yarn format-fix

贡献项目

请阅读 CONTRIBUTING.zh.md。

Warning

请务必遵守贡献者公约。

支持项目

赞助可私信联系@westinyang或扫描下方二维码（微信、支付宝）

Tip

赞助费用请备注“F-OH”或私信告诉@westinyang，方便统计到赞助列表中。

QRCode

对于本项目（F-OH PWA），您可以进入F-OH PWA 捐赠页面支持杰西 205。

许可证

本项目使用 GPL-3.0 许可证，详情请参考 LICENSE 文件。

Copyright (C) 2023 Jesse205

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.