Project Setup and Running Instructions

1. Clone the repository

git clone https://github.com/m5stack/StackChan
cd StackChan/app

2. Open the project in Xcode

Open the project in Xcode:

Double‑click the .xcodeproj file, or open Xcode → File → Open, then select the project.

Select your target device or simulator.

Connect an iPhone (Optional but Recommended)

Connect your iPhone to the Mac using a USB cable.
Unlock the iPhone and tap Trust This Computer if prompted.
In Xcode, select your iPhone as the run destination at the top.

Enable Developer Mode on iPhone (iOS 16+)

Important: Developer Mode will only appear after the iPhone has been connected to Xcode at least once.
If you do not see this option, make sure your iPhone is connected to the Mac, unlocked, trusted, and recognized by Xcode.

On the iPhone, go to Settings → Privacy & Security → Developer Mode.
Turn on Developer Mode and restart the iPhone.
After restart, confirm enabling Developer Mode.

3. Configure Signing & Capabilities

This step allows Xcode to install the app on your iPhone.

In Xcode, select the project in the left sidebar.
Select the app target.
Open the Signing & Capabilities tab.
Sign in with your Apple ID (Xcode → Settings → Accounts → Add Apple ID).
Set Team to your Apple ID.
Change Bundle Identifier to a unique value, for example: com.yourname.stackchan
Ensure no red error messages remain.

Note: A free Apple ID is sufficient for testing on your own iPhone.

4. Modify network configuration

Before running the app, you need to set the correct server IP:

Open the file Network/Urls.swift.
Find the line defining the base URL, for example:

// Base URL configured according to the server's IP
static let url = "192.168.51.24:12800/"

Replace the IP address (192.168.51.24) with the IP of the computer where the server is running.
Save the file.

5. Run the project

Press Cmd + R to build and run the app.

Note: The first build may take several minutes as Xcode prepares the environment.

If running on an iPhone for the first time, you may need to trust yourself as a developer:

On your iPhone, go to Settings → General → VPN & Device Management → Trust Developer and trust the developer profile that appears.

The app will now connect to the server at the IP you configured.

2.4 KiB Raw Permalink Blame History Unescape Escape