macOS build target?

[ringods]

Hello,

I'm new to both iOS or macOS app development. I've read through the iOS options in the docs. Now, would this setup be much different if I want to target building an app for both iOS and macOS?

I would guess the crux part wouldn't be much different, if at all. However, does anyone have pointers documenting the differences?

Ringo

[charypar]

@mhedgpeth You're possibly best placed to comment on Crux on macOS in practice.

In general, I think I would avoid treating them as one Xcode project, purely based on the likelihood of quite different UX patterns in the two. I could imagine there being a fair bit of shared Swift code between them for the core wrapper and possibly the capability implementations - the Foundation frameworks are basically the same, from what I remember.

Making the Crux core and any shared Swift code a Swift package that can be used from either app might work pretty well?

[mhedgpeth]

I'm in the early stages of iOS development and the macOS target is my daily driver, but if it helps here's how I structure things:

name: PeopleWork
projectReferences:
  Shared:
    path: ../shared/shared.xcodeproj
packages:
  PeopleWorkKit:
    path: PeopleWorkKit
options:
  bundleIdPrefix: (redacted)
  fileTypes:
    "icon":
      file: true

# Setting groups - XcodeGen's built-in way to share settings
settingGroups:
  common:
    base:
      MARKETING_VERSION: 0.0.0
      CURRENT_PROJECT_VERSION: 0
      CODE_SIGN_STYLE: Manual
      DEVELOPMENT_TEAM: (redacted)
      DEAD_CODE_STRIPPING: YES
      SWIFT_VERSION: 5.9
      SWIFT_OBJC_BRIDGING_HEADER: generated/sharedFFI.h
      ENABLE_USER_SCRIPT_SANDBOXING: NO
      PRODUCT_NAME: People Work
      EXECUTABLE_NAME: PeopleWork
      APP_URL_SCHEME: peoplework
      "EXCLUDED_SOURCE_FILE_NAMES[arch=*]": uniffi-bindgen
      ASSETCATALOG_COMPILER_APPICON_NAME: AppIcon
    configs:
      Debug:
        CODE_SIGN_STYLE: Manual
        CODE_SIGN_IDENTITY: "-"
        PROVISIONING_PROFILE_SPECIFIER: ""
        CODE_SIGNING_REQUIRED: NO
        CODE_SIGNING_ALLOWED: NO
      Release:
        DEVELOPMENT_TEAM: (redacted)
        PROVISIONING_PROFILE_SPECIFIER: ""
        CODE_SIGN_IDENTITY: "-"
        ENABLE_TESTABILITY: NO
        VALIDATE_PRODUCT: YES

# Target templates - XcodeGen's way to share target configuration
targetTemplates:
  app:
    type: application
    sources:
      - PeopleWorkApp
      - path: ../shared/src/shared.udl
        buildPhase: sources
    scheme:
      gatherCoverageData: true
      buildImplicitDependencies: true
      management:
        shared: true
    settings:
      groups: [common]
    dependencies:
      - sdk: Metal.framework
      - sdk: MetalKit.framework
      - target: Shared/uniffi-bindgen-bin
      - target: Shared/shared-staticlib
      - package: PeopleWorkKit
    buildRules:
      - name: Generate FFI
        filePattern: "*.udl"
        script: |
          #!/bin/bash
          set -e

          # Skip during indexing phase in XCode 13+
          if [ "$ACTION" == "indexbuild" ]; then
            echo "Not building *.udl files during indexing."
            exit 0
          fi

          # Skip for preview builds
          if [ "$ENABLE_PREVIEWS" = "YES" ]; then
            echo "Not building *.udl files during preview builds."
            exit 0
          fi

          cd "${INPUT_FILE_DIR}/.."
          "${BUILD_DIR}/${CONFIGURATION}/uniffi-bindgen" generate "src/${INPUT_FILE_NAME}" --language swift --out-dir "${PROJECT_DIR}/generated"
        outputFiles:
          - $(PROJECT_DIR)/generated/$(INPUT_FILE_BASE).swift
          - $(PROJECT_DIR)/generated/$(INPUT_FILE_BASE)FFI.h
        runOncePerArchitecture: false

targets:
  PeopleWork-macOS:
    templates: [app]
    platform: macOS
    deploymentTarget: "15.6"
    settings:
      base:
        PRODUCT_BUNDLE_IDENTIFIER: (redacted)
        ENABLE_HARDENED_RUNTIME: YES
    info:
      path: PeopleWorkApp/Info.plist
      properties:
        LSMinimumSystemVersion: "15.6"
        LSApplicationCategoryType: public.app-category.business
        NSSupportsAutomaticGraphicsSwitching: true
        CFBundleName: People Work
        CFBundleDisplayName: People Work
        CFBundleShortVersionString: $(MARKETING_VERSION)
        CFBundleVersion: $(CURRENT_PROJECT_VERSION)
        CFBundleURLTypes:
          - CFBundleURLName: $(PRODUCT_BUNDLE_IDENTIFIER)
            CFBundleURLSchemes:
              - $(APP_URL_SCHEME)
    entitlements:
      path: PeopleWorkApp/PeopleWork.entitlements
      properties:
        com.apple.security.app-sandbox: false
        com.apple.security.files.user-selected.read-only: true
        com.apple.security.device.gpu: true
        com.apple.security.hardened-runtime: true

  PeopleWork-iOS:
    templates: [app]
    platform: iOS
    deploymentTarget: "18.0"
    settings:
      base:
        PRODUCT_BUNDLE_IDENTIFIER: io.(redacted)
        TARGETED_DEVICE_FAMILY: "1,2"
        SUPPORTS_MACCATALYST: NO
        CODE_SIGN_STYLE: Automatic
        DEVELOPMENT_TEAM: (redacted) 
    info:
      path: PeopleWorkApp/Info.plist
      properties:
        CFBundleName: People Work
        CFBundleDisplayName: People Work
        CFBundleShortVersionString: $(MARKETING_VERSION)
        CFBundleVersion: $(CURRENT_PROJECT_VERSION)
        UIRequiredDeviceCapabilities: [arm64]
        UISupportedInterfaceOrientations: 
          - UIInterfaceOrientationPortrait
          - UIInterfaceOrientationLandscapeLeft
          - UIInterfaceOrientationLandscapeRight
        UISupportedInterfaceOrientations~ipad:
          - UIInterfaceOrientationPortrait
          - UIInterfaceOrientationPortraitUpsideDown
          - UIInterfaceOrientationLandscapeLeft
          - UIInterfaceOrientationLandscapeRight
        UILaunchStoryboardName: LaunchScreen
        UIRequiresFullScreen: false
        CFBundleURLTypes:
          - CFBundleURLName: $(PRODUCT_BUNDLE_IDENTIFIER)
            CFBundleURLSchemes:
              - $(APP_URL_SCHEME)
    entitlements:
      path: PeopleWorkApp/PeopleWork-iOS.entitlements
      properties:
        com.apple.security.device.gpu: true
    dependencies:
      - sdk: UIKit.framework

To make things easier I put most of my code in a pure swift project called PeopleWorkKit this allows me to compile, lint, and test via terminal commands and it's much faster.

The app written in rust is available for download on my website, https://people-work.io - so if you have any questions on how I did anything, I'd be happy to answer.

I hope that helps!