Connectivity-Free Mode Configuration

Connectivity-Free Mode allows you to use the Super Productivity Android app without an internet connection. This mode is recommended for users who prefer local usage.

Setting Launch Mode to Connectivity-Free

To enable Connectivity-Free Mode, set the LAUNCH_MODE to 0 (Default for new installation) or 2 in the app_config.properties file.

For users performing a new installation, setting LAUNCH_MODE to 2 ensures that the app starts in Connectivity-Free Mode by default. This avoids any attempts to connect to online services, providing a seamless offline experience from the outset.

Important: If you set LAUNCH_MODE to 0, the app will use the default behavior, which may attempt to read from SharedPreferences and connect to online services if available. To maintain a purely offline experience, always set LAUNCH_MODE to 2 for new installations.

Building and Running super-productivity-android Locally

1. Clone the Repository

To set up the project, clone the super-productivity repository instead of directly cloning the super-productivity-android repository. This ensures that all submodules, including the Android project, are properly initialized.

git clone https://github.com/super-productivity/super-productivity.git
cd super-productivity
git submodule init
git submodule update

2. Compile the Node.js Project

Ensure you have Node.js and npm installed. Navigate to the root directory of the super-productivity project and install the necessary dependencies.

npm install

3. Compile the Android Project

From the root directory, compile the Android project using the following commands:

For Testing Builds:
```
npm run dist:android
```
For Production Builds:
```
npm run dist:android:prod
```

4. Installation

You can install the compiled Android application using either Android Studio or npm scripts.

Using Android Studio:
1. Open Android Studio.
2. Select Open an existing project.
3. Navigate to the android directory within the cloned repository.
4. Follow the prompts to build and run the application on your device or emulator.
Using NPM Scripts:
- For Testing Installation:
```
npm run install:android
```
- For Production Installation:
```
npm run install:android:prod
```

Additional Notes

Local Modifications: The app_config.properties file is intended for local modifications only. DO NOT COMMIT this file unless you are absolutely sure of the changes.
No Additional Configuration: Connectivity-Free Mode does not require further configuration beyond setting the LAUNCH_MODE to 0 or 2.

For more information, refer to the main README.

2.8 KiB Raw Blame History