Simplify resource management for iOS

[AlexeyTsvetkov]

With this change:

• Resources from src/<SOURCE_SET_INCLUDED_IN_IOS_COMPILATION>/resources are copied to the application bundle without any additional configuration;
• Resource management is now compatible with regular frameworks (in other words Cocoapods are not required);
• When Cocoapods are used, running podInstall after modifying resources is not required. It is still required to run podInstall once, check the instruction below for details.

Known limitation

⚠️ Copying resources is limited to one module, which produces an iOS framework! Publishing resources and copying resources from other modules will be supported in future versions.

Configuring Cocoapods

1. Remove extraSpecAttributes["resources"] = ... from your Gradle build script:

kotlin {
    ios()
    iosSimulatorArm64()

    cocoapods {
        // ...
        extraSpecAttributes["resources"] = "['src/commonMain/resources/**', 'src/iosMain/resources/**']"
    }
}

2. Run podInstall task once!

Configuring regular frameworks

If your XCode project already has a run phase ./gradlew :shared:embedAndSignAppleFrameworkForXcode, no additional configuration is required.

Converting Cocoapods configuration to regular framework

1. Find the module, which contains Cocoapods configuration. In our pre-1.5 Compose Multiplatform templates and examples that usually was the :shared Gradle module.
2. Run pod deintegrate <PATH_TO_XCODEPROJ_FILE> in the terminal:

cd shared/
pod deintegrate ../iosApp/iosApp.xcodeproj

3. Copy framework configuration from cocoapods to the iOS targets configuration.

kotlin {
    listOf(
        iosX64(),
        iosArm64(),
        iosSimulatorArm64()
    ).forEach { iosTarget ->
        iosTarget.binaries {
            framework {
                // Copy the content of `cocoapods.framework` here
            }
        }
    }

    cocoapods {
        framework {
            // Copy this to the ios targets configuration
        }
    }
}

4. Remove cocoapods section, and the usage of org.jetbrains.kotlin.native.cocoapods plugin from plugins block.
5. Open XCode project in XCode.
6. Add a new run script build phase:

7. Run embedAndSign Gradle task in the new run phase:

cd "$SRCROOT/.."
./gradlew :shared:embedAndSignAppleFrameworkForXcode

8. Move (simply drag&drop) the run phase to run before the compile sources phase.

9. Add the following snippet to the Other Linker flags under the Linking section:

$(inherited) -framework shared

10. Add the following snippet to the Framework Search Paths under the Search Paths section:

$(SRCROOT)/../shared/build/xcode-frameworks/$(CONFIGURATION)/$(SDK_NAME)

Resolves:

• iOS Resources without CocoaPods #3073
• iOS: Include resources without needing to run pod install #3113
• Regular Framework Compose support for iOS #3066

[pjBooms]

• restructure sources in the way that resource management logic will be in a separate package

[dima-avdeev-jb]

Checked in this branch: #3351
Thanks, it works!!!

[pjBooms]

Change this to beta release version after release