Skip to main content

Introduction: Modifying the Cozie App Source Code

Follow these steps to set up your environment and run the Cozie app locally for development:

  1. Download and install Xcode

    • Ensure you have both the iPhone and Apple Watch simulators installed.

  2. Clone the Cozie repository locally You can clone the repository using Git:

    git clone https://github.com/cozie-app/cozie-apple.git
    cd cozie-apple

  3. Install CocoaPods

    • Use Homebrew, you need to have Homebrew installed on your Mac. If you don't haveit, install Homebrew first then run: 
      brew install cocoapods
    • Do not use sudo gem install cocoapods.

  4. Verify CocoaPods installation

    • Run: 
      pod --version

  5. Install project dependencies

    • Make sure you are in the project directory (where the Podfile is located) and run: 
      pod install

  6. Open the project in Xcode

    • From the command line: 
      open Cozie.xcworkspace

  7. Failed Registering Bundle Identifier

    • If you encounter an error about registering the bundle identifier, you can resolve it by:
      • Opening the project in Xcode.
      • Selecting the project in the Project Navigator.
      • Going to the "Signing & Capabilities" tab.
      • I changed mine to com.ft.cozie.apple
      • You will have to change the bundle identifier in both the iOS app and the watch app targets and in OneSignal settings.

  8. Run the app on the iPhone simulator

    • In Xcode, select an iPhone device (e.g., iPhone Pro Max).
    • Press the play button to build and launch the app.
    • Accept all permission requests (location, health data).

  9. Run the Cozie Watch App

    • Change the target to "Cozie Watch App" in Xcode.
    • Press play to launch the Apple Watch simulator.
    • Accept all permission requests.

  10. (Optional) Run on physical devices

    • Connect your iPhone and Apple Watch via cable.
    • Enable developer mode on both devices:
      • On the iPhone, go to Settings > Privacy & Security > Developer Mode.
      • On the Apple Watch, go to Settings > General > Developer.
    • Trust the device when prompted.
    • Allow time for Xcode to set up the devices.
    • In Xcode, select your physical iPhone as the target device.
    • Press play to build and run the app on your iPhone.
    • If it fails, check the errors in the Xcode console. Common issues include:
      • In Signing & Capabilities, ensure you have a valid team selected.
      • Missing permissions
      • Incorrect provisioning profiles
      • Device not trusted
Page Under Development

Additional steps for modifying the source code will be provided soon.

Troubleshooting​

  • Syncing issues: Keep pressing the sync button in the Cozie iPhone app until it works.