mirror of
https://github.com/GLEGram/GLEGram-iOS.git
synced 2026-04-23 11:26:54 +02:00
Leeksov
92 lines
4.7 KiB
Markdown
92 lines
4.7 KiB
Markdown
# CLAUDE.md
|
|
|
|
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
|
|
|
|
## Overview
|
|
|
|
GLEGram — a fork of Swiftgram (which is a fork of Telegram iOS). Base version: Telegram 12.5, Swiftgram 12.5. All GLEGram-specific code is marked with `// MARK: - GLEGram` and `// MARK: - End GLEGram` in Telegram source files.
|
|
|
|
## Build Commands
|
|
|
|
```bash
|
|
# Production IPA (release_arm64)
|
|
./scripts/buildprod.sh
|
|
|
|
# With custom build number
|
|
./scripts/buildprod.sh --buildNumber 100006
|
|
|
|
# Clean build
|
|
./scripts/buildprod.sh --clean
|
|
|
|
# Simulator build
|
|
./scripts/buildsim.sh
|
|
```
|
|
|
|
**Known issue:** Bazel 8.4.2 with embedded JDK 24 crashes on macOS 15.7.4+. The build system auto-applies `--server_javabase` pointing to system JDK 21 (configured in `build-system/Make/Make.py`).
|
|
|
|
**Build target:** `//Telegram:GLEGram` (alias `//Telegram:Swiftgram` for backwards compatibility).
|
|
|
|
**Build configuration:** `build-system/ipa-build-configuration.json` + `build-system/real-codesigning/` for production signing.
|
|
|
|
## Architecture
|
|
|
|
### Three-layer structure
|
|
|
|
1. **Telegram base** (`submodules/`) — Original Telegram iOS code. GLEGram patches are injected with `// MARK: - GLEGram` markers and wrapped in `#if canImport(SGSimpleSettings)` guards.
|
|
|
|
2. **Swiftgram layer** (`Swiftgram/`) — ~50 modules: settings UI, localization, config, badges, logging, requests, API, etc. Core module: `SGSimpleSettings` (UserDefaults-backed settings with 150+ keys). Settings controller: `SGSettingsUI/Sources/SGSettingsController.swift`.
|
|
|
|
3. **GLEGram layer** (`GLEGram/`) — 10 modules with GLEGram-exclusive features:
|
|
- `SGSupporters` — Encrypted badge/subscription API (AES-256 + HMAC-SHA256 + SSL pinning)
|
|
- `SGDeletedMessages` — AyuGram-style saved deleted messages (namespace 1338)
|
|
- `SGFakeLocation` — CLLocationManager swizzling
|
|
- `SGChatExport` — HTML/JSON/TXT export
|
|
- `SGLocalPremium` — Local Premium emulation
|
|
- `DoubleBottom` — Hidden accounts with secret passcode
|
|
- `ChatPassword` — Per-chat password protection
|
|
- `VoiceMorpher` — Voice preset engine
|
|
- `GLESettingsUI` — 18 controllers (paywall, plugins, fonts, fake profile, etc.)
|
|
|
|
### Key modified Telegram files
|
|
|
|
The heaviest GLEGram patches are in:
|
|
- `AppDelegate.swift` — App icons, SGConfig.isBetaBuild, supporters init, ghost delay, deeplinks
|
|
- `ChatController.swift` — Ghost mode delay, saved deleted hooks
|
|
- `AccountStateManagementUtils.swift` — Deleted message saving, edit history
|
|
- `PendingMessageManager.swift` — Ghost delay timer (GhostDelayedSendAttribute)
|
|
- `ManagedAccountPresence.swift` — Periodic offline timer for ghost mode
|
|
- `ManagedLocalInputActivities.swift` — Hide typing/recording/uploading statuses
|
|
- `DeleteMessages.swift` — SavedDeleted namespace handling
|
|
- `PeerInfoScreen.swift` — GLEGram settings tab, badges, export
|
|
- `Font.swift` (Display) — A-Font style font replacement with cache
|
|
- `MTTcpConnection.m` — Custom TLS ClientHello fingerprint
|
|
|
|
### Settings system
|
|
|
|
- `SGSimpleSettings` (`Swiftgram/SGSimpleSettings/Sources/SimpleSettings.swift`) — All settings keys, defaults, UserDefault properties. GLEGram added 80+ keys (ghost mode, deleted messages, font replacement, fake profile, plugins, gated features, etc.)
|
|
- `SGUISettings` (`submodules/TelegramUIPreferences/Sources/Swiftgram/SGUISettings.swift`) — Postbox-backed UI settings
|
|
- GLEGram settings controller: `Swiftgram/SGSettingsUI/Sources/GLEGramSettingsController.swift`
|
|
|
|
### EnqueueMessage.forward
|
|
|
|
GLEGram added `asCopy: Bool` as 6th parameter to `EnqueueMessage.forward`. All `.forward` constructors need `asCopy:` and all destructuring patterns need 6 wildcards. When adding new `.forward` calls, always include `asCopy: false`.
|
|
|
|
### BUILD file conventions
|
|
|
|
GLEGram modules use `//GLEGram/ModuleName:ModuleName` paths. Swiftgram modules use `//Swiftgram/ModuleName:ModuleName`. When adding GLEGram deps to submodule BUILD files, add to the `deps` array (not `sgdeps` which is used for `srcs` in some modules like TelegramUI).
|
|
|
|
## Code Style
|
|
|
|
- **Naming**: PascalCase for types, camelCase for variables/methods
|
|
- **Imports**: Group and sort; use `#if canImport(SGSimpleSettings)` guards for GLEGram imports in Telegram source files
|
|
- **GLEGram markers**: Always wrap GLEGram code in `// MARK: - GLEGram` / `// MARK: - End GLEGram`
|
|
- **No tests** are used
|
|
|
|
## Localization
|
|
|
|
Strings in `Swiftgram/SGStrings/Strings/` (110 language files, 386 strings). Use `i18n("KEY", lang)` for GLEGram-specific strings. Inline Russian/English with `lang == "ru" ? "..." : "..."` is acceptable for GLEGram-only UI.
|
|
|
|
## Config
|
|
|
|
`Swiftgram/SGConfig/Sources/File.swift` — API URLs, supporters API keys, demo login config, `isBetaBuild` flag. Parsed from `BuildConfig.sgConfig` which comes from `variables.bzl` via the build system.
|