WARNING(Chinese only): 本项目受福州大学统一指导，由福州大学计算机与大数据学院、福州大学网络安全与信息化办公室管理（以上单位合称"官方"）。这份源代码使用了宽松开源协议，但源码仅供学习参考，不允许该项目直接或间接性使用/修改后使用在任何非官方和 west2-online 外的应用、网站、app 及任何可以与用户产生交互的互联网信息媒介中。该警告具备行政约束效力。

fzuhelper-app

English | 中文

Overview

fzuhelper-app is a client app that uses React Native cross-end technology. It supports about 20,000 to 30,000 students at Fuzhou University every day. (Data source and introduction to fzuhelper).

fzuhelper was launched in 2015, developed from scratch by west2-online and continuously operated, providing students with industrial-grade practice as much as possible on campus and offering robust support for student employment.

App Previews [click to expand]

Quick Start

This project based on the Node.js, Yarn, make sure to install these software first. It is recommended to use nvm to manage the node version. This project supports running under node v22.

iOS

You need at least a computer with macOS installed. Recommended configuration: MacBook Pro 2021 or later, 32G memory and equipped with M1/M2/M3/M4 Pro/Max/Ultra

Before start, make sure you have installed Xcode from App Store and CocoaPods, all use latest version.

Then follow the steps below in Terminal (iTerm2 is recommended):

# install Xcode commnd line tools
xcode-select --install

# clone repo
git clone https://github.com/west2-online/fzuhelper-app

# install package
yarn install

# prebuild iOS engineering projects
yarn prebuild:ios --clean

# running the dev version on the simulator
yarn ios

# (options) if you need to run on the real device
yarn ios --device

NOTE: You DO NOT NEED to open Xcode for developer unless you are responsible for native related development, for business implementation, you can develop in vscode throughout the process

Android

You need at least a computer with Windows 10 installed. Recommended configuration: Windows 11 Pro, Intel 13th generation or later i5 standard voltage or desktop processor, with at least 32G memory.

Before start, make sure you have installed/created:

1. Android Studio and Android SDK (Version 35, you can install it from Android Studio)
2. OpenJDK (17 or above，winget, Microsoft.OpenJDK.17)
3. an Android Studio emulator, you can follow the instructions in the Expo documentation.

For convenience, you can set environment variable APP_VARIANT=development. This is optional.

This will use a different application identifier than the release, which allows for the coexistence of dev and release versions.

If the environment variable is not set or set to a different value, only the release version of the application identifier will be used.

After you have installed the required software, you can start developing the app.

Clone the repository and install dependencies:

git clone https://github.com/renbaoshuo/fzuhelper-app.git
cd fzuhelper-app
yarn install

Start the app:

yarn android

This will start the Metro bundler and launch the app in the emulator.

Contributors

If you are interested in joining the maintenance of fzuhelper-app, please contact us on our official website