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: HarmonyOS Design
• 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 or Launch

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.

Note

This PWA application will not be able to enter the new page after update, some functions may be abnormal, please refresh before use it.

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.

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. 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 yarn install

Compiling and Hotloading for Development

1. Clone F-OH Data and start a server on port 5500.
2. 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 yarn dev.
   • Windows Tauri software: run yarn 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 yarn build.
     2. Pull F-OH Data into dist/data.
     3. Deploy dist/* to the server.
   • Windows Tauri software:
     1. Run yarn 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

yarn lint-fix
yarn format-fix

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 Hello Tool donation page to support Jesse205.

Contributing

Please read CONTRIBUTING.zh.md.

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