@use-voltra/ios-client 1.4.0 → 2.0.0-rc.1

package/expo-plugin/src/ios-widget/podfile.ts

@@ -0,0 +1,44 @@
+import { ConfigPlugin, withPodfile as withExpoPodfile } from '@expo/config-plugins'
+
+/**
+ * Generates the Podfile target content for the widget extension.
+ */
+function getTargetContent(targetName: string): string {
+  return `
+# Voltra Widget Extension Target
+# DO NOT MODIFY THIS FILE - IT IS AUTO-GENERATED BY THE VOLTRA PLUGIN
+target '${targetName}' do
+  use_frameworks! :linkage => podfile_properties['ios.useFrameworks'].to_sym if podfile_properties['ios.useFrameworks']
+  use_frameworks! :linkage => ENV['USE_FRAMEWORKS'].to_sym if ENV['USE_FRAMEWORKS']
+
+  require 'pathname'
+  project_root = "#{Pod::Config.instance.installation_root}/.."
+  voltra_client_root = \`node --print "require.resolve('@use-voltra/ios-client/package.json', {paths: ['#{project_root}']})" 2>/dev/null\`.strip.gsub('/package.json', '')
+  voltra_widget_podspec_root = File.join(voltra_client_root, 'ios')
+  podspec_dir_path = Pathname.new(voltra_widget_podspec_root).relative_path_from(Pathname.new(__dir__)).to_path
+
+  pod 'VoltraWidget', :path => podspec_dir_path
+end`
+}
+
+export interface ConfigurePodfileProps {
+  targetName: string
+}
+
+/**
+ * Plugin step that adds the Podfile target for the widget extension.
+ */
+export const configurePodfile: ConfigPlugin<ConfigurePodfileProps> = (config, { targetName }) => {
+  return withExpoPodfile(config, (podfile) => {
+    const targetContent = getTargetContent(targetName)
+
+    // Check if target already exists (avoid duplicates)
+    const targetMarker = "target '" + targetName + "'"
+    if (podfile.modResults.contents.includes(targetMarker)) {
+      return podfile
+    }
+
+    podfile.modResults.contents = podfile.modResults.contents + '\n' + targetContent
+    return podfile
+  })
+}

package/expo-plugin/src/ios-widget/widgetPlist.ts

@@ -0,0 +1,115 @@
+import { ConfigPlugin, InfoPlist, withDangerousMod } from '@expo/config-plugins'
+import plist from '@expo/plist'
+import { existsSync, readFileSync, writeFileSync } from 'fs'
+import { join as joinPath } from 'path'
+
+import type { IOSWidgetConfig } from '../types'
+import { logger } from '@use-voltra/expo-plugin'
+
+export interface ConfigureMainAppPlistProps {
+  targetName: string
+  groupIdentifier?: string
+  widgets?: IOSWidgetConfig[]
+  keychainGroup?: string
+}
+
+/**
+ * Plugin step that configures the Info.plist files.
+ *
+ * This:
+ * - Updates the widget extension's Info.plist with URL schemes
+ * - Removes incompatible NSExtension keys for WidgetKit
+ * - Adds group identifier if configured
+ * - Adds server update URLs and intervals for server-driven widgets
+ * - Adds Keychain group for shared credential access
+ */
+export const configureWidgetExtensionPlist: ConfigPlugin<ConfigureMainAppPlistProps> = (
+  expoConfig,
+  { targetName, groupIdentifier, widgets, keychainGroup }
+) =>
+  withDangerousMod(expoConfig, [
+    'ios',
+    async (config) => {
+      if (config.modRequest.introspect) {
+        return config
+      }
+
+      const scheme = typeof expoConfig.scheme === 'string' ? expoConfig.scheme : expoConfig.ios?.bundleIdentifier
+
+      if (scheme) {
+        const targetPath = joinPath(config.modRequest.platformProjectRoot, targetName)
+        const filePath = joinPath(targetPath, 'Info.plist')
+        if (!existsSync(filePath)) {
+          logger.warn(`Widget Info.plist not found at ${filePath}, skipping widget plist updates`)
+          return config
+        }
+
+        const content = plist.parse(readFileSync(filePath, 'utf8')) as InfoPlist
+
+        // WidgetKit extensions must NOT declare NSExtensionPrincipalClass/MainStoryboard.
+        // The @main WidgetBundle in Swift is the entry point.
+        const ext = (content as any).NSExtension as Record<string, any> | undefined
+        if (ext) {
+          delete ext.NSExtensionPrincipalClass
+          delete ext.NSExtensionMainStoryboard
+        }
+
+        // Keep URL schemes in the widget extension so Live Activity links can be resolved
+        // from relative to absolute URLs (see VoltraDeepLinkResolver.swift).
+        const existingTypes = (content.CFBundleURLTypes as any[]) || []
+        const hasScheme = existingTypes.some(
+          (t) => Array.isArray(t?.CFBundleURLSchemes) && t.CFBundleURLSchemes.includes(scheme)
+        )
+        if (!hasScheme) {
+          content.CFBundleURLTypes = [
+            ...existingTypes,
+            {
+              CFBundleURLSchemes: [scheme],
+            },
+          ]
+        } else {
+          content.CFBundleURLTypes = existingTypes
+        }
+
+        // Only set group identifier if provided
+        if (groupIdentifier) {
+          ;(content as any)['Voltra_AppGroupIdentifier'] = groupIdentifier
+        }
+
+        // Configure server update URLs and intervals for widgets with serverUpdate
+        if (widgets && widgets.length > 0) {
+          const serverUrls: Record<string, string> = {}
+          const serverIntervals: Record<string, number> = {}
+          const serverRefresh: Record<string, boolean> = {}
+
+          for (const widget of widgets) {
+            if (widget.serverUpdate) {
+              serverUrls[widget.id] = widget.serverUpdate.url
+              serverIntervals[widget.id] = widget.serverUpdate.intervalMinutes ?? 15
+              if (widget.serverUpdate.refresh) {
+                serverRefresh[widget.id] = true
+              }
+            }
+          }
+
+          if (Object.keys(serverUrls).length > 0) {
+            ;(content as any)['Voltra_WidgetServerUrls'] = serverUrls
+            ;(content as any)['Voltra_WidgetServerIntervals'] = serverIntervals
+          }
+
+          if (Object.keys(serverRefresh).length > 0) {
+            ;(content as any)['Voltra_WidgetServerRefresh'] = serverRefresh
+          }
+        }
+
+        // Add Keychain group for shared credential access
+        if (keychainGroup) {
+          ;(content as any)['Voltra_KeychainGroup'] = keychainGroup
+        }
+
+        writeFileSync(filePath, plist.build(content))
+      }
+
+      return config
+    },
+  ])

package/expo-plugin/src/ios-widget/xcode/buildPhases.ts

@@ -0,0 +1,301 @@
+import { XcodeProject } from '@expo/config-plugins'
+import * as util from 'util'
+
+import type { IOSWidgetExtensionFiles } from '../../types'
+
+const pbxFile = require('xcode/lib/pbxFile')
+
+export interface AddBuildPhasesOptions {
+  targetUuid: string
+  groupName: string
+  productFile: {
+    uuid: string
+    target?: string
+    basename: string
+    group: string
+  }
+  widgetFiles: IOSWidgetExtensionFiles
+}
+
+export interface EnsureBuildPhasesOptions extends AddBuildPhasesOptions {
+  mainTargetUuid?: string
+}
+
+/**
+ * Adds all required build phases for the widget extension target.
+ */
+export function addBuildPhases(xcodeProject: XcodeProject, options: AddBuildPhasesOptions): void {
+  const { targetUuid, groupName, productFile, widgetFiles } = options
+  const buildPath = `""`
+  const folderType = 'app_extension'
+
+  const { swiftFiles, intentFiles, assetDirectories, localizedStringResources } = widgetFiles
+  const resourcePaths = [...assetDirectories, ...localizedStringResources]
+
+  // Sources build phase
+  xcodeProject.addBuildPhase(
+    [...swiftFiles, ...intentFiles],
+    'PBXSourcesBuildPhase',
+    'Sources',
+    targetUuid,
+    folderType,
+    buildPath
+  )
+
+  // Copy files build phase
+  xcodeProject.addBuildPhase(
+    [],
+    'PBXCopyFilesBuildPhase',
+    groupName,
+    xcodeProject.getFirstTarget().uuid,
+    folderType,
+    buildPath
+  )
+
+  xcodeProject.buildPhaseObject('PBXCopyFilesBuildPhase', groupName, productFile.target).files.push({
+    value: productFile.uuid,
+    comment: util.format('%s in %s', productFile.basename, productFile.group),
+  })
+  xcodeProject.addToPbxBuildFileSection(productFile)
+
+  // Frameworks build phase
+  xcodeProject.addBuildPhase([], 'PBXFrameworksBuildPhase', 'Frameworks', targetUuid, folderType, buildPath)
+
+  // Resources build phase
+  xcodeProject.addBuildPhase([...resourcePaths], 'PBXResourcesBuildPhase', 'Resources', targetUuid)
+}
+
+/**
+ * Ensures all required build phases and files exist for the widget extension target.
+ */
+export function ensureBuildPhases(xcodeProject: XcodeProject, options: EnsureBuildPhasesOptions): void {
+  const { targetUuid, groupName, productFile, widgetFiles } = options
+  const buildPath = `""`
+  const folderType = 'app_extension'
+  const mainTargetUuid = options.mainTargetUuid ?? xcodeProject.getFirstTarget().uuid
+
+  const { swiftFiles, intentFiles, assetDirectories, localizedStringResources } = widgetFiles
+  const resourcePaths = [...assetDirectories, ...localizedStringResources]
+
+  dedupeBuildPhasesForTarget(xcodeProject, targetUuid, 'PBXSourcesBuildPhase', 'Sources')
+  dedupeBuildPhasesForTarget(xcodeProject, targetUuid, 'PBXFrameworksBuildPhase', 'Frameworks')
+  dedupeBuildPhasesByComment(xcodeProject, mainTargetUuid, 'PBXCopyFilesBuildPhase', groupName)
+
+  // Sources build phase
+  let sourcesPhase = xcodeProject.buildPhaseObject('PBXSourcesBuildPhase', 'Sources', targetUuid)
+  if (!sourcesPhase) {
+    xcodeProject.addBuildPhase(
+      [...swiftFiles, ...intentFiles],
+      'PBXSourcesBuildPhase',
+      'Sources',
+      targetUuid,
+      folderType,
+      buildPath
+    )
+    sourcesPhase = xcodeProject.buildPhaseObject('PBXSourcesBuildPhase', 'Sources', targetUuid)
+  }
+  if (sourcesPhase) {
+    ensureBuildPhaseFiles(xcodeProject, sourcesPhase, [...swiftFiles, ...intentFiles])
+  }
+
+  // Copy files build phase (embed extension into main app)
+  let copyFilesPhase = xcodeProject.buildPhaseObject('PBXCopyFilesBuildPhase', groupName, mainTargetUuid)
+  if (!copyFilesPhase) {
+    xcodeProject.addBuildPhase([], 'PBXCopyFilesBuildPhase', groupName, mainTargetUuid, folderType, buildPath)
+    copyFilesPhase = xcodeProject.buildPhaseObject('PBXCopyFilesBuildPhase', groupName, mainTargetUuid)
+  }
+  if (copyFilesPhase) {
+    ensureCopyFilesPhaseProduct(xcodeProject, copyFilesPhase, productFile)
+  }
+
+  // Frameworks build phase
+  const frameworksPhase = xcodeProject.buildPhaseObject('PBXFrameworksBuildPhase', 'Frameworks', targetUuid)
+  if (!frameworksPhase) {
+    xcodeProject.addBuildPhase([], 'PBXFrameworksBuildPhase', 'Frameworks', targetUuid, folderType, buildPath)
+  }
+
+  // Resources build phase
+  let resourcesPhase = xcodeProject.buildPhaseObject('PBXResourcesBuildPhase', 'Resources', targetUuid)
+  if (!resourcesPhase) {
+    xcodeProject.addBuildPhase([...resourcePaths], 'PBXResourcesBuildPhase', 'Resources', targetUuid)
+    resourcesPhase = xcodeProject.buildPhaseObject('PBXResourcesBuildPhase', 'Resources', targetUuid)
+  }
+  if (resourcesPhase) {
+    ensureBuildPhaseFiles(xcodeProject, resourcesPhase, [...resourcePaths])
+  }
+}
+
+function dedupeBuildPhasesForTarget(
+  xcodeProject: XcodeProject,
+  targetUuid: string,
+  phaseType: string,
+  preferredComment: string
+): void {
+  const nativeTargets = xcodeProject.pbxNativeTargetSection()
+  const target = nativeTargets[targetUuid]
+  if (!target?.buildPhases) {
+    return
+  }
+
+  const phaseSection = xcodeProject.hash.project.objects[phaseType] || {}
+  const matching = target.buildPhases.filter((entry: any) => phaseSection[entry.value])
+  if (matching.length <= 1) {
+    return
+  }
+
+  const keep = matching.find((entry: any) => entry.comment === preferredComment) ?? matching[0]
+  keep.comment = preferredComment
+
+  target.buildPhases = target.buildPhases.filter((entry: any) => {
+    if (!phaseSection[entry.value]) {
+      return true
+    }
+    return entry.value === keep.value
+  })
+}
+
+function dedupeBuildPhasesByComment(
+  xcodeProject: XcodeProject,
+  targetUuid: string,
+  phaseType: string,
+  comment: string
+): void {
+  const nativeTargets = xcodeProject.pbxNativeTargetSection()
+  const target = nativeTargets[targetUuid]
+  if (!target?.buildPhases) {
+    return
+  }
+
+  const phaseSection = xcodeProject.hash.project.objects[phaseType] || {}
+  const matching = target.buildPhases.filter((entry: any) => phaseSection[entry.value] && entry.comment === comment)
+  if (matching.length <= 1) {
+    return
+  }
+
+  const keep = matching[0]
+  target.buildPhases = target.buildPhases.filter((entry: any) => {
+    if (!phaseSection[entry.value] || entry.comment !== comment) {
+      return true
+    }
+    return entry.value === keep.value
+  })
+}
+
+function normalizePath(value: string | undefined): string {
+  if (!value) {
+    return ''
+  }
+  return value.replace(/^"|"$/g, '')
+}
+
+function findFileReferenceKey(xcodeProject: XcodeProject, filePath: string): string | null {
+  const fileReferenceSection = xcodeProject.pbxFileReferenceSection()
+  const normalizedPath = normalizePath(filePath)
+
+  for (const key of Object.keys(fileReferenceSection)) {
+    if (/_comment$/.test(key)) {
+      continue
+    }
+    const entry = fileReferenceSection[key]
+    const entryPath = normalizePath(entry?.path)
+    if (entryPath === normalizedPath) {
+      return key
+    }
+  }
+
+  return null
+}
+
+function findBuildFileKeyByFileRef(xcodeProject: XcodeProject, fileRef: string): string | null {
+  const buildFileSection = xcodeProject.pbxBuildFileSection()
+  for (const key of Object.keys(buildFileSection)) {
+    if (/_comment$/.test(key)) {
+      continue
+    }
+    const entry = buildFileSection[key]
+    if (entry?.fileRef === fileRef) {
+      return key
+    }
+  }
+  return null
+}
+
+function ensureFileReference(xcodeProject: XcodeProject, filePath: string) {
+  const existingFileRef = findFileReferenceKey(xcodeProject, filePath)
+  const file = new pbxFile(filePath)
+
+  if (existingFileRef) {
+    return { fileRef: existingFileRef, basename: file.basename, group: file.group }
+  }
+
+  file.fileRef = xcodeProject.generateUuid()
+  xcodeProject.addToPbxFileReferenceSection(file)
+  return { fileRef: file.fileRef, basename: file.basename, group: file.group }
+}
+
+function ensureBuildFile(xcodeProject: XcodeProject, filePath: string) {
+  const fileReference = ensureFileReference(xcodeProject, filePath)
+  const existingBuildFile = findBuildFileKeyByFileRef(xcodeProject, fileReference.fileRef)
+
+  if (existingBuildFile) {
+    return { uuid: existingBuildFile, ...fileReference }
+  }
+
+  const file = new pbxFile(filePath)
+  file.uuid = xcodeProject.generateUuid()
+  file.fileRef = fileReference.fileRef
+  xcodeProject.addToPbxBuildFileSection(file)
+  return { uuid: file.uuid, ...fileReference, group: file.group }
+}
+
+function buildPhaseHasFile(xcodeProject: XcodeProject, buildPhase: any, fileRef: string): boolean {
+  if (!buildPhase?.files) {
+    return false
+  }
+  const buildFileSection = xcodeProject.pbxBuildFileSection()
+
+  return buildPhase.files.some((entry: any) => {
+    const buildFile = buildFileSection[entry.value]
+    return buildFile?.fileRef === fileRef
+  })
+}
+
+function ensureBuildPhaseFiles(xcodeProject: XcodeProject, buildPhase: any, filePaths: string[]): void {
+  if (!buildPhase.files) {
+    buildPhase.files = []
+  }
+
+  for (const filePath of filePaths) {
+    const fileReference = ensureFileReference(xcodeProject, filePath)
+    if (buildPhaseHasFile(xcodeProject, buildPhase, fileReference.fileRef)) {
+      continue
+    }
+
+    const buildFile = ensureBuildFile(xcodeProject, filePath)
+    buildPhase.files.push({
+      value: buildFile.uuid,
+      comment: util.format('%s in %s', buildFile.basename, buildFile.group),
+    })
+  }
+}
+
+function ensureCopyFilesPhaseProduct(xcodeProject: XcodeProject, buildPhase: any, productFile: any): void {
+  if (!buildPhase.files) {
+    buildPhase.files = []
+  }
+
+  const alreadyExists = buildPhase.files.some((entry: any) => entry.value === productFile.uuid)
+  if (alreadyExists) {
+    return
+  }
+
+  const buildFileSection = xcodeProject.pbxBuildFileSection()
+  if (!buildFileSection[productFile.uuid]) {
+    xcodeProject.addToPbxBuildFileSection(productFile)
+  }
+
+  buildPhase.files.push({
+    value: productFile.uuid,
+    comment: util.format('%s in %s', productFile.basename, productFile.group),
+  })
+}

package/expo-plugin/src/ios-widget/xcode/configurationList.ts

@@ -0,0 +1,127 @@
+import { XcodeProject } from '@expo/config-plugins'
+
+import { IOS } from '../../constants'
+
+export interface AddConfigurationListOptions {
+  targetName: string
+  bundleIdentifier: string
+  deploymentTarget: string
+  codeSignStyle?: string
+  developmentTeam?: string
+  provisioningProfileSpecifier?: string
+}
+
+function createCommonBuildSettings(options: AddConfigurationListOptions) {
+  const {
+    targetName,
+    bundleIdentifier,
+    deploymentTarget,
+    codeSignStyle,
+    developmentTeam,
+    provisioningProfileSpecifier,
+  } = options
+
+  const commonBuildSettings: Record<string, string> = {
+    PRODUCT_NAME: `"$(TARGET_NAME)"`,
+    SWIFT_VERSION: IOS.SWIFT_VERSION,
+    TARGETED_DEVICE_FAMILY: `"${IOS.DEVICE_FAMILY}"`,
+    INFOPLIST_FILE: `${targetName}/Info.plist`,
+    INFOPLIST_OUTPUT_FORMAT: `"xml"`,
+    CURRENT_PROJECT_VERSION: `"1"`,
+    MARKETING_VERSION: `"1.0"`,
+    IPHONEOS_DEPLOYMENT_TARGET: `"${deploymentTarget}"`,
+    PRODUCT_BUNDLE_IDENTIFIER: `"${bundleIdentifier}"`,
+    SWIFT_OPTIMIZATION_LEVEL: `"-Onone"`,
+    CODE_SIGN_ENTITLEMENTS: `"${targetName}/${targetName}.entitlements"`,
+    APPLICATION_EXTENSION_API_ONLY: '"YES"',
+    ASSETCATALOG_COMPILER_APPICON_NAME: '""',
+  }
+
+  // Synchronize code signing settings from main app target
+  if (codeSignStyle) {
+    commonBuildSettings.CODE_SIGN_STYLE = `"${codeSignStyle}"`
+  }
+  if (developmentTeam) {
+    commonBuildSettings.DEVELOPMENT_TEAM = `"${developmentTeam}"`
+  }
+  if (provisioningProfileSpecifier) {
+    commonBuildSettings.PROVISIONING_PROFILE_SPECIFIER = `"${provisioningProfileSpecifier}"`
+  }
+
+  return commonBuildSettings
+}
+
+/**
+ * Adds the XCConfigurationList for the widget extension target.
+ */
+export function addXCConfigurationList(xcodeProject: XcodeProject, options: AddConfigurationListOptions) {
+  const { targetName } = options
+  const commonBuildSettings = createCommonBuildSettings(options)
+
+  const buildConfigurationsList = [
+    {
+      name: 'Debug',
+      isa: 'XCBuildConfiguration',
+      buildSettings: {
+        ...commonBuildSettings,
+      },
+    },
+    {
+      name: 'Release',
+      isa: 'XCBuildConfiguration',
+      buildSettings: {
+        ...commonBuildSettings,
+      },
+    },
+  ]
+
+  const xCConfigurationList = xcodeProject.addXCConfigurationList(
+    buildConfigurationsList,
+    'Release',
+    `Build configuration list for PBXNativeTarget "${targetName}"`
+  )
+
+  return xCConfigurationList
+}
+
+/**
+ * Ensures an existing XCConfigurationList is updated, or adds a new one if missing.
+ */
+export function ensureXCConfigurationList(
+  xcodeProject: XcodeProject,
+  options: AddConfigurationListOptions,
+  existingConfigurationListId?: string | { value?: string }
+) {
+  const configurationListId =
+    typeof existingConfigurationListId === 'string'
+      ? existingConfigurationListId.split(' ')[0]
+      : existingConfigurationListId?.value?.split(' ')[0]
+  const configurationLists = xcodeProject.pbxXCConfigurationList()
+  const configurationList = configurationListId ? configurationLists?.[configurationListId] : null
+
+  if (!configurationList || !configurationList.buildConfigurations) {
+    return addXCConfigurationList(xcodeProject, options)
+  }
+
+  const commonBuildSettings = createCommonBuildSettings(options)
+  const buildConfigurations = configurationList.buildConfigurations
+  const buildConfigurationSection = xcodeProject.pbxXCBuildConfigurationSection()
+
+  for (const configRef of buildConfigurations) {
+    const configId = typeof configRef === 'string' ? configRef.split(' ')[0] : configRef.value?.split(' ')[0]
+    if (!configId) {
+      continue
+    }
+    const buildConfiguration = buildConfigurationSection[configId]
+    if (!buildConfiguration) {
+      continue
+    }
+
+    buildConfiguration.buildSettings = {
+      ...(buildConfiguration.buildSettings ?? {}),
+      ...commonBuildSettings,
+    }
+  }
+
+  return { uuid: configurationListId }
+}

package/expo-plugin/src/ios-widget/xcode/groups.ts

@@ -0,0 +1,101 @@
+import { XcodeProject } from '@expo/config-plugins'
+
+import type { IOSWidgetExtensionFiles } from '../../types'
+
+const pbxFile = require('xcode/lib/pbxFile')
+
+export interface AddPbxGroupOptions {
+  targetName: string
+  widgetFiles: IOSWidgetExtensionFiles
+}
+
+/**
+ * Adds a PBXGroup for the widget extension files.
+ */
+export function addPbxGroup(xcodeProject: XcodeProject, options: AddPbxGroupOptions): void {
+  const { targetName, widgetFiles } = options
+  const { swiftFiles, intentFiles, assetDirectories, entitlementFiles, plistFiles, localizedStringResources } =
+    widgetFiles
+
+  // Add PBX group with all widget files
+  const { uuid: pbxGroupUuid } = xcodeProject.addPbxGroup(
+    [
+      ...swiftFiles,
+      ...intentFiles,
+      ...entitlementFiles,
+      ...plistFiles,
+      ...assetDirectories,
+      ...localizedStringResources,
+    ],
+    targetName,
+    targetName
+  )
+
+  // Add PBXGroup to top level group
+  const groups = xcodeProject.hash.project.objects['PBXGroup']
+  if (pbxGroupUuid) {
+    Object.keys(groups).forEach(function (key) {
+      if (groups[key].name === undefined && groups[key].path === undefined) {
+        xcodeProject.addToPbxGroup(pbxGroupUuid, key)
+      }
+    })
+  }
+}
+
+/**
+ * Ensures a PBXGroup exists for the widget extension files.
+ */
+export function ensurePbxGroup(xcodeProject: XcodeProject, options: AddPbxGroupOptions): void {
+  const { targetName, widgetFiles } = options
+  const { swiftFiles, intentFiles, assetDirectories, entitlementFiles, plistFiles, localizedStringResources } =
+    widgetFiles
+  const allFiles = [
+    ...swiftFiles,
+    ...intentFiles,
+    ...entitlementFiles,
+    ...plistFiles,
+    ...assetDirectories,
+    ...localizedStringResources,
+  ]
+
+  const existingGroup = xcodeProject.pbxGroupByName(targetName)
+  if (!existingGroup) {
+    addPbxGroup(xcodeProject, options)
+    return
+  }
+
+  if (!existingGroup.children) {
+    existingGroup.children = []
+  }
+
+  for (const filePath of allFiles) {
+    const file = new pbxFile(filePath)
+    const fileRef = ensureFileReference(xcodeProject, filePath)
+    const alreadyInGroup = existingGroup.children.some(
+      (child: any) => child.value === fileRef || child.comment === file.basename
+    )
+    if (!alreadyInGroup) {
+      existingGroup.children.push({ value: fileRef, comment: file.basename })
+    }
+  }
+}
+
+function ensureFileReference(xcodeProject: XcodeProject, filePath: string): string {
+  const fileReferenceSection = xcodeProject.pbxFileReferenceSection()
+  const file = new pbxFile(filePath)
+
+  for (const key of Object.keys(fileReferenceSection)) {
+    if (/_comment$/.test(key)) {
+      continue
+    }
+    const entry = fileReferenceSection[key]
+    const entryPath = typeof entry?.path === 'string' ? entry.path.replace(/^"|"$/g, '') : ''
+    if (entryPath === file.path || entryPath === filePath) {
+      return key
+    }
+  }
+
+  file.fileRef = xcodeProject.generateUuid()
+  xcodeProject.addToPbxFileReferenceSection(file)
+  return file.fileRef
+}