mirror of
https://github.com/ichmagmaus111/ghostgram.git
synced 2026-05-01 04:07:51 +02:00
ichmagmaus 812
83 lines
2.6 KiB
Markdown
83 lines
2.6 KiB
Markdown
# Ghostgram iOS Compilation Guide
|
|
|
|
> **Important**: Notifications, calls, and some other cloud-dependent features may not be fully implemented in this fork's development builds. For daily use, it is recommended to keep the official Telegram App installed.
|
|
|
|
## 🛠 Prerequisites
|
|
|
|
- **macOS**: Latest version recommended.
|
|
- **Xcode**: See `versions.json` for the exact required version.
|
|
- **Bazel**: Managed via the build system.
|
|
- **Python**: 3.x
|
|
|
|
---
|
|
|
|
## 🚀 Quick Start
|
|
|
|
### 1. Obtain Telegram API Credentials
|
|
1. Go to [my.telegram.org](https://my.telegram.org).
|
|
2. Log in and create a new application to get your `api_id` and `api_hash`.
|
|
|
|
### 2. Get the Source Code
|
|
```bash
|
|
git clone --recursive -j8 https://github.com/TelegramMessenger/Telegram-iOS.git
|
|
# Note: In this fork, ensure you have all submodules
|
|
```
|
|
|
|
### 3. Setup Xcode Configuration
|
|
1. Generate a random 8-character hex identifier:
|
|
```bash
|
|
openssl rand -hex 8
|
|
```
|
|
2. Create a dummy Xcode project named `Telegram` with organization identifier `org.<YOUR_HEX_ID>`.
|
|
3. Locate your **Team ID** in Keychain Access (Organizational Unit of your Apple Development certificate).
|
|
4. Edit `build-system/template_minimal_development_configuration.json` with your credentials and Team ID.
|
|
|
|
### 4. Generate Xcode Project
|
|
```bash
|
|
python3 build-system/Make/Make.py \
|
|
--cacheDir="$HOME/telegram-bazel-cache" \
|
|
generateProject \
|
|
--configurationPath=build-system/template_minimal_development_configuration.json \
|
|
--xcodeManagedCodesigning
|
|
```
|
|
|
|
---
|
|
|
|
## 🏗 Advanced Build Options
|
|
|
|
### Building an IPA (Release)
|
|
1. Configure `build-system/appstore-configuration.json`.
|
|
2. Ensure you have the correct provisioning profiles.
|
|
3. Run:
|
|
```bash
|
|
python3 build-system/Make/Make.py \
|
|
--cacheDir="$HOME/telegram-bazel-cache" \
|
|
build \
|
|
--configurationPath=your_config.json \
|
|
--codesigningInformationPath=your_profiles_dir \
|
|
--buildNumber=100001 \
|
|
--configuration=release_arm64
|
|
```
|
|
|
|
### Simulator Build (No Codesigning)
|
|
Add `--disableProvisioningProfiles` to the generation command to build for the simulator without needing a development certificate.
|
|
|
|
---
|
|
|
|
## ❓ FAQ & Troubleshooting
|
|
|
|
### "build-request.json not updated yet"
|
|
If Xcode hangs with this message, cancel the build and restart it.
|
|
|
|
### "no such package @rules_xcodeproj_generated"
|
|
This usually happens after a system restart or clearing Bazel cache. Re-run the `generateProject` command.
|
|
|
|
### Overriding Xcode Version
|
|
If you have a newer/older Xcode than what is specified in `versions.json`, use:
|
|
```bash
|
|
python3 build-system/Make/Make.py --overrideXcodeVersion generateProject ...
|
|
```
|
|
|
|
---
|
|
Report all issues/bugs on Telegram [@ceopoco](https://t.me/ceopoco)
|