Project Configuration
After obtaining the project (either by cloning or downloading from the releases page), follow these steps to configure it properly:
- Remove .Git Folder - If you cloned the project, delete the
.git
folder to start with a clean history.
TIP
Once the .git folder is removed you can run git init
command to start a new repository
Rename Project - In Xcode, click on the project name and enter your desired name. When prompted, click "Rename" to update all project content items.
Update Target Information - Navigate to the TARGETS page and:
- Under the General tab, modify the Display Name and Version
- Under Signing & Capabilities, set a unique bundle identifier (using reverse-DNS format with only alphanumeric characters, hyphens, and periods)
TIP
A bundle ID uniquely identifies a single app throughout the system. The bundle ID string must contain only alphanumeric characters (A–Z, a–z, and 0–9), hyphens (-), and periods (.). Typically, you use a reverse-DNS format for bundle ID strings. Bundle IDs are case-insensitive.
Update Info.plist - Locate and edit the
info.plist
file to change:- Bundle display name
- Bundle version string (short)
Reset Scheme - From Xcode's Product menu, go to:
- Scheme > Manage Schemes...
- Delete the current scheme using the minus (-) button
- Click "Autocreate Schemes Now" to generate a fresh scheme
Configure Web Project - The
www
folder contains your web project:- Use the existing content as a starting point or replace it with your own
- The
enClose.js
file, which enables JavaScript/Swift communication, must be kept and included in your web project