Language - Swift: Difference between revisions

From Phidgets Support
No edit summary
No edit summary
 
Line 1: Line 1:
{{#seo:|description=Learn how to use Phidget USB devices with Swift.}}
[[Category:Language]]
[[Category:Language]]
__NOTOC__


We provide support for the Swift language on macOS. We also provide instructions on how to get your project started in Xcode for use in '''macOS''' and '''iOS''' applications. Select your operating system below, and follow the instructions to get your project running with Phidgets.
== Get Started ==
With the Phidget22 library, it's easy to create Swift applications that work with Phidget devices.


Once you have set up your development environment to run with Phidgets, we recommend you follow our guide on [[Phidget Programming Basics]]. The guide will showcase the fundamentals of programming with Phidgets.
== Swift Libraries ==
If you've installed the Phidget drivers for  [[OS - macOS|macOS]] or [[OS - iOS|iOS]], then you already have the files you need for your project.  


==Setup Guide==
== Example Code ==
You can find examples for macOS and iOS on our [https://www.phidgets.com/?view=code_samples&lang=Swift Code Samples] page. Make sure you download one for the correct OS.


<div class="phd-deck-sequence">
[[Image:swift_example2.png|link=|center|750px]]
  __NOTOC__
{{PT3_SWIFT_CHOOSE}}
{{PT3_SWIFT_MAC_XCODE}}
{{PT3_SWIFT_MAC_XCODE_1}}
{{PT3_SWIFT_MAC_XCODE_2}}
{{PT3_SWIFT_IOS_XCODE}}
{{PT3_SWIFT_IOS_XCODE_1}}
{{PT3_SWIFT_IOS_XCODE_2}}
</div>


== XCode Configuration ==
[https://developer.apple.com/xcode/ Xcode] is an IDE provided by Apple that's used to develop code in a wide variety of programming languages, including Swift.


== Quick Downloads ==
=== macOS ===
{| style="margin:auto;" class="table-no-border mw-collapsible mw-collapsed"
|+ '''Instructions'''
|colspan="2"|{{hiddenh4|Use Our Examples}}||
|-
|colspan="2"|Start by downloading a [https://www.phidgets.com/?view=code_samples&lang=Swift Swift example] that will work with your Phidget.


If you already know what you're doing and just need the files, you can find them all below.
Open the folder and run '''Package.swift''' to open it in Xcode.
|-
| Next, simply press run. ||[[Image:Macos_swift_run2.png|link=https://cdn.phidgets.com/docs/images/b/b9/Macos_swift_run2.png|350px]]
|-
| Here's what the VoltageInput example will look like when it's running. Try playing around with the device and experiment with some of its functionality. The next step is configuring a new project and writing your own code. || [[Image:Macos_swift_output.png|link=https://cdn.phidgets.com/docs/images/0/00/Macos_swift_output.png|350px]]
|-
|colspan="2"|{{hiddenh4|Starting a New Project}}
|-
| Create a new XCode project and select a macOS app. || [[Image:Macos_new_proj.png|link=https://cdn.phidgets.com/docs/images/0/04/Macos_new_proj.png|350px]]
|-
| Name the project, select Swift as the language, and continue. || [[Image:Macos_new_nameproject.png|link=https://cdn.phidgets.com/docs/images/f/fb/Macos_new_nameproject.png|350px]]
|-
| Now that your project is created, you need to add the Phidget libraries.


=== Documentation ===
Go to File > '''Add Package Dependencies'''
|[[Image:Macos_swift_addpackage.png|link=https://cdn.phidgets.com/docs/images/1/13/Macos_swift_addpackage.png|350px]]
|-
| This will pop up the Swift package manager. || [[Image:Macos_swift_packageblank.png|link=https://cdn.phidgets.com/docs/images/3/3f/Macos_swift_packageblank.png|350px]]
|-
|Type this URL into the search bar in the top right:
<syntaxhighlight>https://www.phidgets.com/git/phidget22-swift.git</syntaxhighlight>
Then select the phidget22-swift package and click '''Add Package'''.
| [[Image:Macos_swift_packageurl.png|link=https://cdn.phidgets.com/docs/images/f/ff/Macos_swift_packageurl.png|350px]]
|-
|colspan="2"| Now you can access the Phidget libraries by adding the following line to the top of your files:
<syntaxhighlight>import Phidget22Swift</syntaxhighlight>
The project now has access to Phidgets you can begin coding. See [[Phidget Programming Basics]] for guidance on writing your own code.
|}


*{{Phidget22API}} (select Swift from the drop-down menu)
=== iOS ===
{| style="margin:auto;" class="table-no-border mw-collapsible mw-collapsed"
|+ '''Instructions'''
|colspan="2"|{{hiddenh4|Use Our Examples}}||
|-
|colspan="2"|Start by downloading a [https://www.phidgets.com/?view=code_samples&lang=Swift Swift example] that will work with your Phidget.


=== Example Code ===
Open the folder and run '''Package.swift''' to open it in Xcode.
|-
| Next, select the type of device you would like the application to run on, and press play. || [[Image:ios_swift_select_target.png|link=https://cdn.phidgets.com/docs/images/9/90/Ios_swift_select_target.png|350px]]
|-
|Here's what the VoltageInput example will look like when it's running. Try playing around with the device and experiment with some of its functionality. The next step is starting a new project and writing your own code.|| [[Image:ios_swift_output.png|link=https://cdn.phidgets.com/docs/images/1/1d/Ios_swift_output.png|200px]]
|-
|colspan="2"|{{hiddenh4|Starting a New Project}}
|-
|  Create a new XCode project and select an iOS app. || [[Image:ios_new_proj.png|link=https://cdn.phidgets.com/docs/images/d/d9/Ios_new_proj.png|350px]]
|-
| Name the project, select Swift as the language, and choose which devices will be supported. || [[Image:ios_new_nameproject.png|link=https://cdn.phidgets.com/docs/images/8/86/Ios_new_nameproject.png|350px]]
|-
| Now that your project is created, you need to add the Phidget libraries.
Go to '''File > Add Package Dependencies'''
| |[[Image:Macos_swift_addpackage.png|link=https://cdn.phidgets.com/docs/images/1/13/Macos_swift_addpackage.png|350px]]
|-
| This will pop up the Swift package manager. || [[Image:Macos_swift_packageblank.png|link=https://cdn.phidgets.com/docs/images/3/3f/Macos_swift_packageblank.png|350px]]
|-
|Type this URL into the search bar in the top right:
<syntaxhighlight>https://www.phidgets.com/git/phidget22-swift.git</syntaxhighlight>
Then select the phidget22-swift package and click '''Add Package'''.
| [[Image:Macos_swift_packageurl.png|link=https://cdn.phidgets.com/docs/images/f/ff/Macos_swift_packageurl.png|350px]]
|-
|colspan="2"| Now you can access the Phidget libraries by adding the following line to the top of your files:
<syntaxhighlight>import Phidget22Swift</syntaxhighlight>
The project now has access to Phidgets you can begin coding. See [[Phidget Programming Basics]] for guidance on writing your own code.
|}


*{{SampleCode|Swift|Swift Examples}}
==Phidget Programming Basics==
{{PhidgetProgrammingBasicsLink}}


===Libraries===
==API==
 
[{{SERVER}}/?view=api&lang=Swift Phidget22 API]
{{MacQuickDownloads}}
{{iOSQuickDownloads}}

Latest revision as of 21:03, 17 March 2026


Get Started

With the Phidget22 library, it's easy to create Swift applications that work with Phidget devices.

Swift Libraries

If you've installed the Phidget drivers for macOS or iOS, then you already have the files you need for your project.

Example Code

You can find examples for macOS and iOS on our Code Samples page. Make sure you download one for the correct OS.

Swift example2.png

XCode Configuration

Xcode is an IDE provided by Apple that's used to develop code in a wide variety of programming languages, including Swift.

macOS

Instructions
Use Our Examples
Start by downloading a Swift example that will work with your Phidget.

Open the folder and run Package.swift to open it in Xcode.

Next, simply press run. Macos swift run2.png
Here's what the VoltageInput example will look like when it's running. Try playing around with the device and experiment with some of its functionality. The next step is configuring a new project and writing your own code. Macos swift output.png
Starting a New Project
Create a new XCode project and select a macOS app. Macos new proj.png
Name the project, select Swift as the language, and continue. Macos new nameproject.png
Now that your project is created, you need to add the Phidget libraries.

Go to File > Add Package Dependencies

Macos swift addpackage.png
This will pop up the Swift package manager. Macos swift packageblank.png
Type this URL into the search bar in the top right: 
https://www.phidgets.com/git/phidget22-swift.git

Then select the phidget22-swift package and click Add Package.

Macos swift packageurl.png
Now you can access the Phidget libraries by adding the following line to the top of your files: 
import Phidget22Swift

The project now has access to Phidgets you can begin coding. See Phidget Programming Basics for guidance on writing your own code.

iOS

Instructions
Use Our Examples
Start by downloading a Swift example that will work with your Phidget.

Open the folder and run Package.swift to open it in Xcode.

Next, select the type of device you would like the application to run on, and press play. Ios swift select target.png
Here's what the VoltageInput example will look like when it's running. Try playing around with the device and experiment with some of its functionality. The next step is starting a new project and writing your own code. Ios swift output.png
Starting a New Project
Create a new XCode project and select an iOS app. Ios new proj.png
Name the project, select Swift as the language, and choose which devices will be supported. Ios new nameproject.png
Now that your project is created, you need to add the Phidget libraries.

Go to File > Add Package Dependencies

Macos swift addpackage.png
This will pop up the Swift package manager. Macos swift packageblank.png
Type this URL into the search bar in the top right: 
https://www.phidgets.com/git/phidget22-swift.git

Then select the phidget22-swift package and click Add Package.

Macos swift packageurl.png
Now you can access the Phidget libraries by adding the following line to the top of your files: 
import Phidget22Swift

The project now has access to Phidgets you can begin coding. See Phidget Programming Basics for guidance on writing your own code.

Phidget Programming Basics

To learn more about the structure of the example code, visit our Phidget Programming Basics guide.

API

Phidget22 API

Retrieved from "https://www.phidgets.com/docs/index.php?title=Language_-_Swift&oldid=35534"