@bacons/apple-targets 0.2.0 → 3.0.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2023 evanbacon
+Copyright (c) 2025 Evan Bacon
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -9,7 +9,7 @@ An experimental Expo Config Plugin that generates native Apple Targets like Widg
 
 ## 🚀 How to use
 
-> This plugin requires at least CocoaPods 1.16.2 (ruby 3.2.0), Xcode 16 (macOS 15 Sequoia), and Expo SDK +52.
+> This plugin requires at least CocoaPods 1.16.2 (ruby 3.2.0), Xcode 16 (macOS 15 Sequoia), and Expo SDK +53.
 
 1. Run `npx create-target` in your Expo project to generate an Apple target.
 2. Select a target to generate, I recommend starting with a `widget` (e.g. `npx create-target widget`). This will generate the required widget files in the root `/targets` directory, install `@bacons/apple-targets`, and add the Expo Config Plugin to your project.
@@ -42,7 +42,7 @@ Some targets have special entitlements behavior:
 Any changes you make outside of the `expo:targets` directory in Xcode are subject to being overwritten by the next `npx expo prebuild --clean`. Check to see if the settings you want to toggle are available in the Info.plist or the `expo-target.config.js` file.
 If you modify the `expo-target.config.js` or your root `app.json`, you will need to re-run `npx expo prebuild --clean` to sync the changes.
 
-You can use the custom Prebuild template `--template node_modules/@bacons/apple-targets/prebuild-blank.tgz` to create a build without React Native, this can make development a bit faster since there's less to compile.
+You can use the custom Prebuild template `--template ./node_modules/@bacons/apple-targets/prebuild-blank.tgz` to create a build without React Native, this can make development a bit faster since there's less to compile. This is an advanced technique for development **NOT PRODUCTION** and is not intended to be used with third-party Config Plugins.
 
 ## Target config
 
@@ -220,6 +220,8 @@ module.exports = {
 
 ### `action`
 
+![IMG_C2C825ACC8C7-1](https://github.com/user-attachments/assets/8378e022-2061-4da8-9c46-efe3064dd40c)
+
 These show up in the share sheet. The icon should be transparent as it will be masked by the system.
 
 ```js
@@ -318,7 +320,7 @@ If you experience issues building widgets, it might be because React Native is s
 Some workarounds:
 
 - Clear the SwiftUI previews cache: `xcrun simctl --set previews delete all`
-- Prebuild without React Native: `npx expo prebuild --template node_modules/@bacons/apple-targets/prebuild-blank.tgz --clean`
+- Prebuild without React Native: `npx expo prebuild --template ./node_modules/@bacons/apple-targets/prebuild-blank.tgz --clean`
 - If the widget doesn't show on the home screen when building the app, use iOS 18. You can long press the app icon and select the widget display options to transform the app icon into the widget.
 
 ## Sharing data between targets
@@ -410,8 +412,78 @@ For more advanced uses, I recommend the following resources:
 
 This plugin makes use of my proprietary Xcode parsing library, [`@bacons/xcode`](https://github.com/evanbacon/xcode). It's mostly typed, very untested, and possibly full of bugs––however, it's still 10x nicer than the alternative.
 
+## Control widgets
+
+![Simulator Screenshot - iPhone 16 - 2025-01-26 at 15 57 44](https://github.com/user-attachments/assets/c989a3bb-112d-4026-a718-49de4cdb2f3e)
+
+[Control widgets](https://developer.apple.com/documentation/swiftui/controlwidget) are a type of widget that appears in the control center, Siri suggestions, the lock screen, and Shortcuts.
+
+Generally, you'll want to add control widgets to a `widget` target, but they can be added to any target really.
+
+You can add multiple intents, they should be in the `[target]/_shared/*.swift` folder so they can be added to the main target as well as the widget target, this is required to make them work correctly.
+
+The following is an example of a control widget that launches a universal link for my app.
+
+```swift
+// targets/widget/_shared/intents.swift
+
+import AppIntents
+import SwiftUI
+import WidgetKit
+
+// TODO: These must be added to the WidgetBundle manually. They need to be linked outside of the _shared folder.
+// @main
+// struct exportWidgets: WidgetBundle {
+//     var body: some Widget {
+//         widgetControl0()
+//         widgetControl1()
+//     }
+// }
+
+@available(iOS 18.0, *)
+struct widgetControl0: ControlWidget {
+    // Unique ID for the control.
+    static let kind: String = "com.bacon.clipdemo.0"
+    var body: some ControlWidgetConfiguration {
+      StaticControlConfiguration(kind: Self.kind) {
+        ControlWidgetButton(action: OpenAppIntent0()) {
+          // You can also use a custom image but it must be an SF Symbol.
+          Label("App Settings", systemImage: "star")
+        }
+      }
+      // This is the configuration for the widget.
+      .displayName("Launch Settings")
+      .description("A control that launches the app settings.")
+    }
+}
+
+// This must be in both targets when `openAppWhenRun = true`. We can do that by adding it to the _shared folder.
+// https://developer.apple.com/forums/thread/763851
+@available(iOS 18.0, *)
+struct OpenAppIntent0: ControlConfigurationIntent {
+    static let title: LocalizedStringResource = "Launch Settings"
+    static let description = IntentDescription(stringLiteral: "A control that launches the app settings.")
+    static let isDiscoverable = true
+    static let openAppWhenRun: Bool = true
+
+    @MainActor
+    func perform() async throws -> some IntentResult & OpensIntent {
+        // Here's the URL we want to launch. It can be any URL but it should be a universal link for your app.
+        return .result(opensIntent: OpenURLIntent(URL(string: "https://pillarvalley.expo.app/settings")!))
+    }
+}
+```
+
+You should copy the intents into your main `WidgetBundle` struct.
+
+Custom images can be used but they must be SF Symbols, you can use a tool like [Create Custom Symbols](https://github.com/jaywcjlove/create-custom-symbols) to do this. Then simply add to the Assets.xcassets folder and reference it in the `Label`.
+
+You can do a lot of things with Control Widgets like launching a custom UI instead of opening the app. This plugin should allow for most of these things to work.
+
 ## App Clips
 
+![IMG_6BC9D9534F1D-1](https://github.com/user-attachments/assets/f9847f6f-4f0a-44f9-932c-3f8e9703c133)
+
 App Clips leverage the true power of Expo Router, enabling you to link a website and native app to just instantly open the native app on iOS. They're pretty hard to get working though.
 
 Here are a few notes from my experience building https://pillarvalley.expo.app (open on iOS to test).

package/build/config-plugin.js

@@ -20,7 +20,7 @@ const withTargetsDir = (config, _props) => {
         hasWarned = true;
         console.warn((0, chalk_1.default) `{yellow [bacons/apple-targets]} Expo config is missing required {cyan ios.appleTeamId} property. Find this in Xcode and add to the Expo Config to correct. iOS builds may fail until this is corrected.`);
     }
-    const targets = (0, glob_1.sync)(`${root}/${match}/expo-target.config.@(json|js)`, {
+    const targets = (0, glob_1.globSync)(`${root}/${match}/expo-target.config.@(json|js)`, {
         // const targets = globSync(`./targets/action/expo-target.config.@(json|js)`, {
         cwd: projectRoot,
         absolute: true,

package/build/icon/withImageAsset.js

@@ -27,7 +27,7 @@ exports.generateWatchIconsInternalAsync = exports.generateIconsInternalAsync = e
 const config_plugins_1 = require("@expo/config-plugins");
 const image_utils_1 = require("@expo/image-utils");
 const AssetContents_1 = require("@expo/prebuild-config/build/plugins/icons/AssetContents");
-const fs = __importStar(require("fs-extra"));
+const fs = __importStar(require("fs"));
 const path_1 = __importStar(require("path"));
 const withImageAsset = (config, { cwd, name, image }) => {
     return (0, config_plugins_1.withDangerousMod)(config, [
@@ -37,7 +37,9 @@ const withImageAsset = (config, { cwd, name, image }) => {
             const iosNamedProjectRoot = (0, path_1.join)(projectRoot, cwd);
             const imgPath = `Assets.xcassets/${name}.imageset`;
             // Ensure the Images.xcassets/AppIcon.appiconset path exists
-            await fs.ensureDir((0, path_1.join)(iosNamedProjectRoot, imgPath));
+            await fs.promises.mkdir((0, path_1.join)(iosNamedProjectRoot, imgPath), {
+                recursive: true,
+            });
             const userDefinedIcon = typeof image === "string"
                 ? { "1x": image, "2x": undefined, "3x": undefined }
                 : image;
@@ -120,7 +122,9 @@ exports.ICON_CONTENTS = [
 ];
 async function setIconsAsync(icon, projectRoot, iosNamedProjectRoot, cacheComponent) {
     // Ensure the Images.xcassets/AppIcon.appiconset path exists
-    await fs.ensureDir((0, path_1.join)(iosNamedProjectRoot, IMAGESET_PATH));
+    await fs.promises.mkdir((0, path_1.join)(iosNamedProjectRoot, IMAGESET_PATH), {
+        recursive: true,
+    });
     // Finally, write the Config.json
     await (0, AssetContents_1.writeContentsJsonAsync)((0, path_1.join)(iosNamedProjectRoot, IMAGESET_PATH), {
         images: await generateIconsInternalAsync(icon, projectRoot, iosNamedProjectRoot, cacheComponent),
@@ -154,7 +158,7 @@ async function generateResizedImageAsync(icon, name, projectRoot, iosNamedProjec
             });
             // Write image buffer to the file system.
             const assetPath = (0, path_1.join)(iosNamedProjectRoot, `Assets.xcassets/${name}.imageset`, filename);
-            await fs.writeFile(assetPath, source);
+            await fs.promises.writeFile(assetPath, source);
             if (filename) {
                 imgEntry.filename = filename;
             }
@@ -196,7 +200,7 @@ async function generateIconsInternalAsync(icon, projectRoot, iosNamedProjectRoot
                     });
                     // Write image buffer to the file system.
                     const assetPath = (0, path_1.join)(iosNamedProjectRoot, IMAGESET_PATH, filename);
-                    await fs.writeFile(assetPath, source);
+                    await fs.promises.writeFile(assetPath, source);
                     // Save a reference to the generated image so we don't create a duplicate.
                     generatedIcons[filename] = true;
                 }
@@ -234,7 +238,7 @@ async function generateWatchIconsInternalAsync(icon, projectRoot, iosNamedProjec
     });
     // Write image buffer to the file system.
     const assetPath = (0, path_1.join)(iosNamedProjectRoot, IMAGESET_PATH, filename);
-    await fs.writeFile(assetPath, source);
+    await fs.promises.writeFile(assetPath, source);
     imagesJson.push({
         filename: getAppleIconName(size, 1),
         idiom: "universal",

package/build/icon/withIosIcon.js

@@ -27,7 +27,7 @@ exports.generateWatchIconsInternalAsync = exports.generateIconsInternalAsync = e
 const config_plugins_1 = require("@expo/config-plugins");
 const image_utils_1 = require("@expo/image-utils");
 const AssetContents_1 = require("@expo/prebuild-config/build/plugins/icons/AssetContents");
-const fs = __importStar(require("fs-extra"));
+const fs = __importStar(require("fs"));
 const path_1 = require("path");
 // TODO: support dark, tinted, and universal icons for widgets.
 const withIosIcon = (config, { cwd, type, iconFilePath, isTransparent = false }) => {
@@ -38,7 +38,9 @@ const withIosIcon = (config, { cwd, type, iconFilePath, isTransparent = false })
             const namedProjectRoot = (0, path_1.join)(projectRoot, cwd);
             if (type === "watch") {
                 // Ensure the Images.xcassets/AppIcon.appiconset path exists
-                await fs.ensureDir((0, path_1.join)(namedProjectRoot, IMAGESET_PATH));
+                await fs.promises.mkdir((0, path_1.join)(namedProjectRoot, IMAGESET_PATH), {
+                    recursive: true,
+                });
                 // Finally, write the Config.json
                 await (0, AssetContents_1.writeContentsJsonAsync)((0, path_1.join)(namedProjectRoot, IMAGESET_PATH), {
                     images: await generateWatchIconsInternalAsync(iconFilePath, projectRoot, namedProjectRoot, cwd, isTransparent),
@@ -119,7 +121,9 @@ exports.ICON_CONTENTS = [
 ];
 async function setIconsAsync(icon, projectRoot, iosNamedProjectRoot, cacheComponent, isTransparent) {
     // Ensure the Images.xcassets/AppIcon.appiconset path exists
-    await fs.ensureDir((0, path_1.join)(iosNamedProjectRoot, IMAGESET_PATH));
+    await fs.promises.mkdir((0, path_1.join)(iosNamedProjectRoot, IMAGESET_PATH), {
+        recursive: true,
+    });
     // Finally, write the Config.json
     await (0, AssetContents_1.writeContentsJsonAsync)((0, path_1.join)(iosNamedProjectRoot, IMAGESET_PATH), {
         images: await generateIconsInternalAsync(icon, projectRoot, iosNamedProjectRoot, cacheComponent, isTransparent),
@@ -158,7 +162,7 @@ async function generateIconsInternalAsync(icon, projectRoot, iosNamedProjectRoot
                     });
                     // Write image buffer to the file system.
                     const assetPath = (0, path_1.join)(iosNamedProjectRoot, IMAGESET_PATH, filename);
-                    await fs.writeFile(assetPath, source);
+                    await fs.promises.writeFile(assetPath, source);
                     // Save a reference to the generated image so we don't create a duplicate.
                     generatedIcons[filename] = true;
                 }
@@ -196,7 +200,7 @@ async function generateWatchIconsInternalAsync(icon, projectRoot, iosNamedProjec
     });
     // Write image buffer to the file system.
     const assetPath = (0, path_1.join)(iosNamedProjectRoot, IMAGESET_PATH, filename);
-    await fs.writeFile(assetPath, source);
+    await fs.promises.writeFile(assetPath, source);
     imagesJson.push({
         filename: getAppleIconName(size, 1),
         idiom: "universal",

package/build/withWidget.js

@@ -65,7 +65,7 @@ const withWidget = (config, props) => {
     // TODO: Are there characters that aren't allowed in `CFBundleDisplayName`?
     const targetDisplayName = (_a = props.name) !== null && _a !== void 0 ? _a : productName;
     const targetDirAbsolutePath = path_1.default.join((_c = (_b = config._internal) === null || _b === void 0 ? void 0 : _b.projectRoot) !== null && _c !== void 0 ? _c : "", props.directory);
-    const entitlementsFiles = (0, glob_1.sync)("*.entitlements", {
+    const entitlementsFiles = (0, glob_1.globSync)("*.entitlements", {
         absolute: true,
         cwd: targetDirAbsolutePath,
     });
@@ -260,6 +260,7 @@ const withWidget = (config, props) => {
         frameworks: (0, target_1.getFrameworksForType)(props.type).concat(props.frameworks || []),
         type: props.type,
         teamId: props.appleTeamId,
+        colors: props.colors,
         exportJs: (_j = props.exportJs) !== null && _j !== void 0 ? _j : 
         // Assume App Clips are used for React Native.
         props.type === "clip",

package/build/withXcodeChanges.d.ts

@@ -12,7 +12,7 @@ export type XcodeSettings = {
     frameworks: string[];
     type: ExtensionType;
     hasAccentColor?: boolean;
-    colors?: Record<string, string>;
+    colors?: Record<string, any>;
     teamId?: string;
     icon?: string;
     exportJs?: boolean;

package/build/withXcodeChanges.js

@@ -14,9 +14,8 @@ const TemplateBuildSettings = XCBuildConfiguration_json_1.default;
 const withXcparse_1 = require("./withXcparse");
 const assert_1 = __importDefault(require("assert"));
 const withXcodeChanges = (config, props) => {
-    return (0, withXcparse_1.withXcodeProjectBeta)(config, (config) => {
-        // @ts-ignore
-        applyXcodeChanges(config, config.modResults, props);
+    return (0, withXcparse_1.withXcodeProjectBeta)(config, async (config) => {
+        await applyXcodeChanges(config, config.modResults, props);
         return config;
     });
 };
@@ -553,7 +552,7 @@ function getDeviceFamilyBuildSettings(deviceFamilies) {
         TARGETED_DEVICE_FAMILY: families.join(","),
     };
 }
-function createConfigurationList(project, { name, cwd, bundleId, deploymentTarget, currentProjectVersion, }) {
+function createWidgetConfigurationList(project, { name, cwd, bundleId, deploymentTarget, currentProjectVersion, }) {
     const debugBuildConfig = xcode_1.XCBuildConfiguration.create(project, {
         name: "Debug",
         buildSettings: {
@@ -641,7 +640,7 @@ function createConfigurationList(project, { name, cwd, bundleId, deploymentTarge
 }
 function createConfigurationListForType(project, props) {
     if (props.type === "widget") {
-        return createConfigurationList(project, props);
+        return createWidgetConfigurationList(project, props);
     }
     else if (props.type === "action") {
         return createExtensionConfigurationListFromTemplate(project, "com.apple.services", props);
@@ -732,7 +731,7 @@ async function applyXcodeChanges(config, project, props) {
         }
     }
     function configureTargetWithEntitlements(target) {
-        const entitlements = (0, glob_1.sync)("*.entitlements", {
+        const entitlements = (0, glob_1.globSync)("*.entitlements", {
             absolute: false,
             cwd: magicCwd,
         });
@@ -754,7 +753,7 @@ async function applyXcodeChanges(config, project, props) {
         });
     }
     function configureTargetWithPreview(target) {
-        const assets = (0, glob_1.sync)("preview/*.xcassets", {
+        const assets = (0, glob_1.globSync)("preview/*.xcassets", {
             absolute: true,
             cwd: magicCwd,
         })[0];
@@ -874,7 +873,7 @@ async function applyXcodeChanges(config, project, props) {
             fs_1.default.statSync(path_1.default.join(assetsDir, file)).isDirectory())
             .map((file) => path_1.default.join("assets", file));
     const protectedGroup = ensureProtectedGroup(project, path_1.default.dirname(props.cwd));
-    const sharedAssets = (0, glob_1.sync)("_shared/*", {
+    const sharedAssets = (0, glob_1.globSync)("_shared/*", {
         absolute: false,
         cwd: magicCwd,
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bacons/apple-targets",
-  "version": "0.2.0",
+  "version": "3.0.0",
   "description": "Generate Apple Targets with Expo Prebuild",
   "main": "build/ExtensionStorage.js",
   "types": "build/ExtensionStorage.d.ts",
@@ -33,15 +33,13 @@
   "author": "Evan Bacon",
   "license": "MIT",
   "dependencies": {
-    "@react-native/normalize-colors": "^0.76.1",
-    "glob": "^10.2.6",
     "@bacons/xcode": "1.0.0-alpha.24",
-    "fs-extra": "^11.2.0",
+    "@react-native/normalize-colors": "^0.79.2",
+    "glob": "^10.4.2",
     "debug": "^4.3.4"
   },
   "devDependencies": {
     "@types/debug": "^4.1.7",
-    "@types/fs-extra": "^11.0.4",
     "@types/glob": "^8.1.0",
     "@expo/babel-preset-cli": "^0.3.1",
     "chalk": "^4.0.0",