EasyApp

Installation Guide

How to set up EasyApp in your development environment.

Prerequisites

Before you begin, ensure you have the following requirements met:

  • macOS: 15.0 Sequoia or later
  • Xcode: 16.0 or later
  • Apple Developer Program: Active membership required
  • Github account: Access to the code repository
  • Git: For downloading/cloning the repository
  • iPhone device: For real device testing/debugging, in-app purchase testing must use real device
  • Internet connection: For downloading third-party dependency repositories

How to register Apple Developer Account

Reference official documentation: Apple Developer Account Registration

First, when you purchase EasyApp, you will receive an email with access invitations to EasyApp's frontend and backend code repositories. You need to accept these invitations to have permission to access the code repositories. Next, you need to clone the code repositories locally and configure the Xcode project.

Clone Repository

Recommended to fork the repository, then clone the forked repository locally. This way the repository you clone is also private, and you can pull from the main repository to update code at any time.

fork_repo

git clone https://github.com/your-username/easyapp-swiftui.git your-project-name

You can also directly clone the code repository

git clone https://github.com/sunshineLixun/easyapp-swiftui.git your-project-name

cd your-project-name

git remote remove origin

You can also directly download the ZIP file download_zip

You can also directly open the project with Xcode (need to install Xcode first) open_with_xcode

Configure Xcode

A good network environment is a necessary condition for improving development efficiency

  • For mainland China, installing SPM dependencies requires enabling proxy TUN mode to make normal requests.
  • Or use Proxifier tool to enable proxy. For how to use Proxifier, please search by yourself. Compared to the cumbersome configuration of using Proxifier tool, it is strongly recommended to enable proxy TUN mode.
  • For how to enable proxy TUN mode, please search by yourself.
  • Recommend using Clash Verge tool to enable proxy.

1. Open project in Xcode:

Go to your cloned code repository, double-click the EasyAppSwiftUI.xcodeproj file to open the project.

open_xcode_project

2. Select development team (as shown below):

  • In Xcode, select the project file (steps 1 and 2)
  • Go to "Signing & Capabilities" (step 3)
  • Select your Apple developer team (step 4)

3. Update Bundle Identifier:

  • Change bundle identifier to match your developer account (step 5)
  • Example: com.yourcompany.easyappswiftui

edit_project_name

4. Rename project (this step is optional):

  • Since this only modifies the project name, not the App name. If you don't care, you can skip this step.
  • After selecting the project name, click again or press Enter to enter edit mode (as shown below)

edit_project_name2

  • Taking this project as an example, we modify it to EasyAppSwiftUI_Copy (as shown below), edit_project_name3

  • After modification, click/press Enter to complete the modification. A popup will remind you, click rename and continue.

edit_project_name4

  • After renaming, Xcode will re-index the entire project. project_indexing

  • If we reopen the project, it will re-request all SPM dependencies. fetch_dependencies

5. Verify project runs normally

  • After you get the project, or if you performed step 4, it's recommended to execute Command + B to verify the project builds normally.
  • If everything is normal, you'll see a Build Success prompt.

build_success

Reminder

  • If project build fails due to dependency errors, it might be Xcode having issues during project renaming. Please try the following:
  • Execute Command + Shift + K to clean cache
  • Execute File > Packages > Reset Package Caches reset_package_caches
  • Wait for Xcode to complete dependency download processing
  • If still not resolved, try completely exiting Xcode then restarting and executing:
  • Command + Shift + K to clean cache
  • File > Packages > Reset Package Caches
  • Allow/trust any popups that appear
  • If dependency errors still exist, your Package.resolved file might be corrupted. Please delete that file and let Xcode regenerate it. See this Stack Overflow issue
  • Generally, this situation won't occur. If you really encounter it and have tried all the above methods but still can't resolve it, please contact us

6. Modify App name

  • If all the above steps went smoothly, you can start modifying your App name (as shown below).
  • Select step 1, find Display Name, modify to your App name (step 2). For example, we change the App name to EasyAppCopy.

edit_app_name

Run App

  • Execute Command + R to run the App.
  • At this point you should see the App has been installed on the desktop and the App name has been changed to EasyAppCopy.

desktop

  • Next, you'll enter the onboarding flow. Congratulations, you have successfully run EasyApp 🎉🎉🎉🎉🎉

first_lanuch

Next you need to configure your own keys and set up some tedious content. Such as in-app purchases, backend services, etc. Don't worry, follow the rhythm and you'll quickly launch an MVP project. Here are the subsequent steps:

Last updated on