Easy methods to Share SwiftUI Code Utilizing Swift Packages

0
53

[ad_1]

Within the earlier tutorial, we created an animated menu bar in SwiftUI. What if you wish to reuse the code in different tasks? In fact, you may copy & paste the code from one mission to a different however there’s a higher strategy to reuse the code through the use of Swift Bundle.

Swift packages are reusable elements that builders can import of their tasks. With Swift Bundle Supervisor, the built-in device for creating and managing Swift packages, you may simply share reusable code within the type of Swift packages.

On this tutorial, I’ll stroll you thru the method of making Swift packages and present you how one can flip the code of the animated menu bar right into a reusable SwiftUI element.

Please notice that I exploit Xcode 13 to create the demo code. Nonetheless, it’s best to be capable of comply with procedures even in case you are utilizing a decrease model of Xcode.

Creating Swift Packages

There are two methods to create a Swift bundle. You’ll be able to both use command line or Xcode.

Utilizing Command Line

To create a Swift bundle utilizing command line, open Terminal and key within the following instructions:

The folder title is the bundle title. Right here, we use the title AnimatedMenuBar. When you hit the return key, you will note the next messages:

This generates the fundamental skeleton of the Swift bundle together with the supply and checks. You’ll be able to additional edit README.md file to supply an outline of the bundle. Bundle.swift is the manifest file which defines the bundle’s title and its contents utilizing the PackageDescription module.

Observe that the bundle manifest should start with the string // swift-tools-version:, adopted by a model quantity similar to // swift-tools-version:5.3.

Utilizing Xcode

If you happen to desire to make use of Xcode to create the bundle, you may select File > New > Mission… and choose Swift Bundle below Multiplatform.

Xcode-create-swift-packages

Updating the Supply

The AnimatedMenuBar.swift file below the Sources folder solely incorporates the default content material generated by Xcode:

You need to replace the file with the code for creating the animated menu bar. On this case, we reuse the code that now we have walked you thru within the earlier tutorial.

For Swift bundle, the AnimatedMenuBar struct is required to set to public. And we have to create a customized init with public entry degree.

Besides that, the remainder of the code is sort of the identical. You could discover one other distinction that we use the @obtainable attribute to annotate the struct with availability info. The road of code signifies that the struct is barely obtainable for iOS 14 and macOS 11.0 (or later).

Enhancing Take a look at Code

By default, Xcode generates a check folder so that you can embody automated checks. You’ll be able to modify the generated file named AnimatedMenuBarTests.swift to incorporate your check code. Nonetheless, for this demo, we aren’t going to put in writing the code. You’ll be able to simply remark out the next line of code:

Including Dependencies (Elective)

Although this bundle doesn’t rely on different Swift packages, you may edit the dependencies part to incorporate your dependent packages should you want:

Including Supported Platforms

Whereas Swift packages are supposed to supply multiplatform help, you should utilize the platforms attribute in Bundle.swift if the bundle solely helps a sure platform. Right here is an instance:

For this demo bundle, it’s obtainable for iOS 14 and macOS 11.0 (or later).

Publishing the Bundle on GitHub

After you made all of the modifications, it’s best to be capable of construct your bundle to make use of it domestically. To additional share the bundle with builders in your staff or neighborhood, you may publish the bundle on GitHub.

Go as much as the Xcode menu and select Supply Management > New Git Repositories… to create a brand new respository.

Xcode-create-git-repository

Subsequent, change over to the Supply Management Navigator. Proper click on Remotes and select New “AnimatedMenuBar ” Distant

Xcode-remote-git-repository

Assuming you’ve already configured your GitHub account in Xcode, it’s best to be capable of create a distant repository. Set the repository title to AnimatedMenuBar and key in your description of the bundle. Relying in your choice, you can also make the bundle obtainable to public or simply maintain it to your individual mission. For this demo, I set it to public.

create-remote-git

When you hit the Create button, Xcode will create the repository on GitHub and add the native information to the repository.

Presently, the bundle shouldn’t be assigned with a model quantity. To set a model for the bundle, go to the Supply Management Navigator. Proper click on the entry of the preliminary commit and select Tag.

swift-manage-git-tag

Subsequent, set the tag to 1.0.0 and click on Create to verify the change.

Xcode-add-tag-version

The change you simply made is barely obtainable domestically. To set the tag on the distant repository, it’s essential to push the modifications. Go as much as the Xcode menu, select Supply Management > Push. Please be sure you tick the Embody tags checkbox earlier than hitting the Push button.

git-push-tag

That’s it! You’ve efficiently revealed the Swift bundle onto GitHub. And, it’s accessible by way of https://github.com/appcoda/AnimatedMenuBar.

Utilizing Swift Bundle

To make use of the Swift bundle in any Xcode mission, select File > Add Bundle… and key within the bundle URL within the search bar.

using-swift-package

Xcode ought to then present you the bundle description and model. Click on Add Bundle to obtain and add the bundle to your mission.

import-swift-package

As soon as the bundle is downloaded, it’s best to see the bundle below Bundle Dependencies within the mission navigator. Now you might be prepared to make use of the AnimatedMenuBar view within the mission.

All it’s essential to do is import the AnimatedMenuBar bundle and use the AnimatedMenuBar view like this:

Abstract

On this tutorial, I’ve walked you thru the steps to create a Swift bundle for reusing some frequent SwiftUI views. The method shouldn’t be restricted to the reuse of SwiftUI views. You’ll be able to apply it to frequent elements that may be shared between groups and tasks.

What do you concentrate on Swift packages? Have you ever used Swift Bundle Supervisor to create shareable elements? Please go away me remark and let me know.



[ad_2]