F-OH PWA

中文 | English | More translations are welcome!

F-OH is an application center for FOSS (Free and Open Source Software) on the OpenHarmony platform with download and installation support.

F-OH PWA is a cross-platform third-party F-OH based on a browser version of the Sparkling Store V3 Demo.

F-OH PWA + BrowserCE, best practices for distributing OpenHarmony hap apps via web pages, might be a good choice for teams with internal distribution of test hap apps.

2023-12-29 F-OH Suspension Notice

Screenshots

Features

• Design: Multi-design-language
  • HarmonyOS Design
  • Material Design 2
  • Fluent Design 2 (not yet realized)
• Platform: Browser, Linux, Windows
• Advertising: None
• Fees: None for now
• Source code: Open sourced to Gitee and GitHub
• Internationalization: Multilingual based on Vue I18n

Download & Use

The F-OH PWA offers a choice between standalone software and web access.

• F-OH Tauri : Deep system integration, near-native experience, no automatic updates, available offline, fast loading.
  • Gitee Releases
• F-OH Lite、F-OH PWA : Click-and-go, automatic update, no download required.
  • Release: http://74.48.94.162:5000/ (Discontinued)
  • Development: https://f-oh-pwa-jesse205.netlify.app/

Tip

F-OH PWA is temporarily unavailable because the server does not have SSL and has cross-domain issues (No security context to meet the minimum requirements to be a PWA), please use F-OH Tauri or F-OH Lite (Web). If you want to use use the PWA, use the development version deployed on Netlify.

PWA Installation

A progressive web app (PWA) is an app that's built using web platform technologies, but that provides a user experience like that of a platform-specific app. (From MDN)

Some browsers support installing this website to the desktop by clicking "Install Application". After installation, the application name will change from F-OH Lite to F-OH PWA.

Tip

For more information about using PWAs, see Use Progressive Web Apps in Microsoft Edge.

Change the API url

The default API url is /api, and you can replace it in three ways.

1. Modify the .env file, replacing FOHPWA_URL_API_WEB, FOHPWA_URL_API_WEB_ORIGIN, FOHPWA_URL_API_CLIENT, and FOHPWA_URL_API_CLIENT_ORIGIN with your own API url, and then build and publish.
2. Directly modify the API url in the application settings.
3. Add ?apiUrl=<Your API url> to the application link to temporarily override the API url.

Series of Projects

• F-OH: F-OH OpenHarmony Mobile
• F-OH Data: metadata for all F-OH apps, where developers PR submit their apps
• F-OH Server: F-OH server, providing interface services, platform management, etc. (to be developed)
• F-OH Website: F-OH website, including documents, blogs, selected applications, etc. (to be developed)

Project Setup

1. Install NodeJS v21 and pnpm
2. (Optional, only required if a Tauri application needs to be developed) Set up the Tauri environment according to Tauri prep.
   • Windows: Microsoft Visual Studio C++ Builder, WebView2, Rust.
   • macOS: CLang and macOS development dependencies, Rust.
   • Linux: system dependencies, Rust.
3. Run pnpm install.

Compiling and Hotloading for Development

1. Clone F-OH Data and start a server.
2. (Optional) Save [ .env.development.local.example](. /.env.development.local.example) as .env.development.local and configure some variables.
3. Open a terminal in the project and run commands according to the following rules.
   • Web and PWA applications: run pnpm dev:web.
   • Windows Tauri software: run pnpm dev:tauri.

Compiling and Streamlining for Production

1. Set up the .env.production file.
2. Follow the example in [.env.development.local.example](. /.env.development.local.example) to configure the data server as shown in the example.
3. Open a terminal in the project and run commands according to the following rules.
   • Web pages and PWA applications:
     1. Run pnpm build:web.
     2. (Optional) Pull F-OH Data into dist/data.
     3. Deploy dist/* to the server.
   • Windows Tauri software:
     1. Run pnpm build:tauri.
     2. Release src-tauri\target\release\F-OH Tauri.exe and src-tauri\target\release\bundle\nsis\F-OH Tauri_<version>_x64-setup.exe.

Lint and Fixing Files

pnpm lint-fix
pnpm format-fix

Contributing

Please read CONTRIBUTING.md.

Warning

Please be sure to follow the Contributor Covenant Code of Conduct.

Support Program

Sponsorship can be contacted by private message or scanning the QR code below (WeChat, Alipay)

Note

Please note "F-OH" or private message to @westinyang (Gitee) for sponsorship fee, so that it can be counted in Sponsor List.

For this project (F-OH PWA), you can go to the F-OH PWA donation page to support Jesse205.

License

This project uses the GPL-3.0 license, see the LICENSE file for details.

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/>.