@hanafe/rn-release

@hanafe/rn-release is a CLI tool for managing releases of React Native projects. It helps with versioning, building, and deploying your app for both Android and iOS platforms.

This is a basic tool. More functionalities are to be added soon. For contribution contact me at miraahanafee@gmail.com

NOTE: A previous version of this same package named rn-hanafe is now deprecated

Features

- Update package.json version automatically.
- Update Android build.gradle versionName and versionCode.
- Update iOS Info.plist CFBundleShortVersionString and CFBundleVersion.
- Build release APKs for Android.
- Build archives for iOS.
- Create Git commits and tags for releases.
- Stream-install APKs to multiple connected Android devices.

Installation

Install the CLI globally using npm:

`bash
npm install -g @hanafe/rn-release
`

Usage

Run the CLI using the command:

`bash
@hanafe/rn-release [options]
`

$3

####

release



Prepare and build a new release for your React Native project.

`bash
@hanafe/rn-release release [options]
`

##### Options:
- -v, --version : Specify the version type (major, minor, patch) or a specific version (e.g., 1.2.3).
- -p, --platform : Specify the platform to build for (android, ios, both). Default is both.
- -t, --tag: Create a Git commit and tag for the release. Default is true.

##### Example:
`bash
@hanafe/rn-release release -v minor -p android
`

#### stream-install

Stream-install an APK to multiple connected Android devices via ADB.

`bash
@hanafe/rn-release stream-install
`

This command detects connected Android devices and installs the release APK (android/app/build/outputs/apk/release/app-release.apk) on selected devices.

#### init

Initialize project settings (functionality to be implemented).

`bash
@hanafe/rn-release init
`

$3

If no options are provided for the

release

command, the CLI will prompt you for:
- Version type (major, minor, patch, or custom).
- Platform to build for (android, ios, or both).
- Whether to create a Git commit and tag.

$3

1. Navigate to the root of your React Native project.
2. Run the

release

command:
`bash
@hanafe/rn-release release
`
3. Follow the prompts to update the version, build the app, and create a Git tag.

$3

- Node.js >= 16.0.0
- For Android builds:
- Android SDK and Gradle installed.
- For iOS builds:
- Xcode and command-line tools installed.
- PlistBuddy available (comes with macOS).

$3

- Ensure you are in the root directory of your React Native project.
- Make sure

package.json

exists in the project root.
- For Android builds, ensure the android/app/build.gradle file exists.
- For iOS builds, ensure the ios directory contains a valid .xcodeproj or .xcworkspace`.

$3

This project is licensed under the MIT License.