MAX Messenger Webview

Приложение которое открывает веб версию мессенджера MAX в Webview с подходящим user agent. Регистрация не поддерживается также, как и в обычной веб версии https://web.max.ru App that opens the web version of the MAX messenger in a Webview with the appropriate user agent. Registration is not supported as well as in the regular web version https://web.max.ru

Download / Скачать

English

Download the latest release from GitHub Releases.

Русский

Скачайте последний релиз из GitHub Releases.

---

Build Instructions / Инструкции по сборке

Prerequisites / Требования

English

Required for all platforms:

• Node.js (v18 or higher) or Bun (latest version)
• Git

For Android builds:

• Java Development Kit (JDK) 21 - Required for Android builds
• Android SDK - Android Studio or standalone SDK
  • Android SDK Platform 33 or higher
  • Android SDK Build-Tools
  • Android SDK Command-line Tools
• ANDROID_HOME environment variable set to your Android SDK path
• JAVA_HOME environment variable set to your JDK 21 path

For iOS builds:

• macOS (required for iOS development)
• Xcode (latest version recommended)
• Xcode Command Line Tools
• CocoaPods (will be installed automatically if missing)

Русский

Требуется для всех платформ:

• Node.js (v18 или выше) или Bun (последняя версия)
• Git

Для сборки Android:

• Java Development Kit (JDK) 21 - Требуется для сборки Android
• Android SDK - Android Studio или автономный SDK
  • Android SDK Platform 33 или выше
  • Android SDK Build-Tools
  • Android SDK Command-line Tools
• Переменная окружения ANDROID_HOME, указывающая на путь к Android SDK
• Переменная окружения JAVA_HOME, указывающая на путь к JDK 21

Для сборки iOS:

• macOS (требуется для разработки iOS)
• Xcode (рекомендуется последняя версия)
• Xcode Command Line Tools
• CocoaPods (будет установлен автоматически, если отсутствует)

---

Installation Steps / Шаги установки

English

1. Install Node.js/Bun:

# Using Homebrew (macOS)
brew install node
# or
brew install bun

# Or download from:
# Node.js: https://nodejs.org/
# Bun: https://bun.sh/

2. Install Java 21 (for Android):

# Using Homebrew (macOS)
brew install openjdk@21

# Set JAVA_HOME (add to ~/.zshrc or ~/.bash_profile)
export JAVA_HOME=$(/usr/libexec/java_home -v 21)

3. Install Android SDK:

• Download and install Android Studio
• Or install Android SDK Command-line Tools manually
• Set ANDROID_HOME environment variable:

# Add to ~/.zshrc or ~/.bash_profile
export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/emulator
export PATH=$PATH:$ANDROID_HOME/platform-tools
export PATH=$PATH:$ANDROID_HOME/tools
export PATH=$PATH:$ANDROID_HOME/tools/bin

4. Install Xcode (for iOS):

• Download from Mac App Store
• Install Command Line Tools:

xcode-select --install

5. Install CocoaPods (for iOS):

sudo gem install cocoapods

Русский

1. Установите Node.js/Bun:

# Используя Homebrew (macOS)
brew install node
# или
brew install bun

# Или скачайте с:
# Node.js: https://nodejs.org/
# Bun: https://bun.sh/

2. Установите Java 21 (для Android):

# Используя Homebrew (macOS)
brew install openjdk@21

# Установите JAVA_HOME (добавьте в ~/.zshrc или ~/.bash_profile)
export JAVA_HOME=$(/usr/libexec/java_home -v 21)

3. Установите Android SDK:

• Скачайте и установите Android Studio
• Или установите Android SDK Command-line Tools вручную
• Установите переменную окружения ANDROID_HOME:

# Добавьте в ~/.zshrc или ~/.bash_profile
export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/emulator
export PATH=$PATH:$ANDROID_HOME/platform-tools
export PATH=$PATH:$ANDROID_HOME/tools
export PATH=$PATH:$ANDROID_HOME/tools/bin

4. Установите Xcode (для iOS):

• Скачайте из Mac App Store
• Установите Command Line Tools:

xcode-select --install

5. Установите CocoaPods (для iOS):

sudo gem install cocoapods

---

Build Commands / Команды сборки

English

1. Clone the repository and install dependencies:

git clone https://github.com/your-username/max-messenger-webview.git
cd max-messenger-webview

# Install dependencies using Bun (recommended) or npm
bun install
# or
npm install

2. Build Android Release APK:

bun run ar
# or
npm run ar

The release APK will be created at: app-release.apk in the project root.

3. Build iOS IPA:

bun run ios-build
# or
npm run ios-build

The IPA file will be created at: MAX.ipa in the project root.

Note: The iOS build creates an unsigned IPA that can be installed using TrollStore.

Русский

1. Клонируйте репозиторий и установите зависимости:

git clone https://github.com/your-username/max-messenger-webview.git
cd max-messenger-webview

# Установите зависимости используя Bun (рекомендуется) или npm
bun install
# или
npm install

2. Соберите Android Release APK:

bun run ar
# или
npm run ar

Release APK будет создан в: app-release.apk в корне проекта.

3. Соберите iOS IPA:

bun run ios-build
# или
npm run ios-build

IPA файл будет создан в: MAX.ipa в корне проекта.

Примечание: iOS сборка создает неподписанный IPA, который можно установить используя TrollStore.

---

Troubleshooting / Решение проблем

English

Android build issues:

• Ensure JAVA_HOME points to JDK 21: echo $JAVA_HOME
• Verify Android SDK is installed: echo $ANDROID_HOME
• Check Gradle version compatibility
• Clean build: cd android && ./gradlew clean && cd ..

iOS build issues:

• Ensure Xcode Command Line Tools are installed
• Run pod install manually in the ios directory if needed
• Check Xcode version compatibility
• Clean build: cd ios && xcodebuild clean && cd ..

Русский

Проблемы со сборкой Android:

• Убедитесь, что JAVA_HOME указывает на JDK 21: echo $JAVA_HOME
• Проверьте установку Android SDK: echo $ANDROID_HOME
• Проверьте совместимость версии Gradle
• Очистите сборку: cd android && ./gradlew clean && cd ..

Проблемы со сборкой iOS:

• Убедитесь, что установлены Xcode Command Line Tools
• Запустите pod install вручную в директории ios при необходимости
• Проверьте совместимость версии Xcode
• Очистите сборку: cd ios && xcodebuild clean && cd ..