You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Nov 17, 2022. It is now read-only.
Copy file name to clipboardExpand all lines: docs/tooling/ios-app-extensions.md
+13-13Lines changed: 13 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,25 +1,25 @@
1
1
---
2
2
title: iOS App Extensions
3
-
description: iOS App extensions give users access to the app’s functionality and content throughout iOS. The App extensions provides options for interacting with other applications and enabled the user to access the app’s features without having to open it!
4
-
position: 200
3
+
description: iOS App extensions give users access to the app’s functionality and content throughout iOS. The App extensions provide options for interacting with other applications and enabled the user to access the app’s features without having to open it!
4
+
position: 100
5
5
slug: ios-app-extensions
6
6
---
7
7
8
8
# iOS App Extensions
9
9
10
-
iOS App extensions give users access to the app’s functionality and content throughout iOS. The App extensions provide options for interacting with other applications and enabled the user to access the app’s features without having to open it! As of the current latest version of XCode there over 25 different App Extensions templates. They cover functionalities like sharing, photo editing, file system access, widgets, custom notifications, actions, custom keyboars and many more. Each extension is part of the app but also work independently of one another. For more details on the different types of iOS App Extensions refer to the official [Apple documentation](https://developer.apple.com/app-extensions/).
10
+
iOS App extensions give users access to the app’s functionality and content throughout iOS. The App extensions provide options for interacting with other applications and enabled the user to access the app’s features without having to open it! As of the current latest version of XCode there over 25 different App Extensions templates. They cover functionalities like sharing, photo editing, file system access, widgets, custom notifications, actions, custom keyboards and many more. Each extension is part of the app but also work independently of one another. For more details on the different types of iOS App Extensions refer to the official [Apple documentation](https://developer.apple.com/app-extensions/).
11
11
12
12
## App Extensions in NativeScript
13
13
14
-
NativeScript CLI 5.3.0 introduced a built-in support for the iOS App Extensions. While the extension itself should be created and developed via Xcode (using Objective-C), the produced files can be integrated in existing NativeScript app by using a plugin (that contains the extension) or directly by introducing the extension fule in folder special folder `<project-name>/App_Resources/iOS/extensions`. The following sections will describe the steps needed to integrate the **created** App Extension into your existing NativeScript application.
14
+
NativeScript CLI 5.3.0 introduced built-in support for the iOS App Extensions. While the extension itself should be created and developed via Xcode (using Objective-C), the produced files can be integrated into existing NativeScript app by using a plugin (that contains the extension) or directly by introducing the extension file in folder particular folder `<project-name>/App_Resources/iOS/extensions`. The following sections describe the steps needed to integrate the **created** App Extension into your existing NativeScript application.
15
15
16
16
17
17
### Adding App Extension in Existing Application
18
18
19
19
Prerequisites
20
20
21
-
- The created App Extensions (**add link here**)
22
-
- Existing NativeScript applicaiton. For testing purposes, you can build base application using the `create` command
21
+
- The created App Extensions (**add a link here**)
22
+
- Existing NativeScript application. For testing purposes, you can build a base application using the `create` command
23
23
24
24
```
25
25
tns create today-extension --tsc
@@ -29,9 +29,9 @@ Steps to include the App Extension
29
29
30
30
1. Open `<project-name>/app/App_Resources/iOS/` and create folder named `extensions` (**add link here**)
31
31
32
-
2. In the `extensions` folder paste the main folder that contains the extension files. For example, paste the `TestExtension` folder containg all the extension files. (**add link here**)
32
+
2. In the `extensions` folder paste the main folder that contains the extension files. For example, paste the `TestExtension` folder containing all the extension files. (**add link here**)
33
33
34
-
3. In the `TestExtension` folder (where the extension files resides), create a file called `extension.json`. This configuration file describes the SDK frameworks used in the extension (via `frameworks` key) and the optional image resources used for extension icon (via `assetcatalogCompilerAppiconName` key).
34
+
3. In the `TestExtension` folder (where the extension files reside), create a file called `extension.json`. This configuration file describes the SDK frameworks used in the extension (via `frameworks` key) and the optional image resources used for extension icon (via `assetcatalogCompilerAppiconName` key).
35
35
36
36
For example:
37
37
```JSON
@@ -46,11 +46,11 @@ Where:
46
46
- `frameworks` key - the value is an array of framework names.
47
47
- `assetcatalogCompilerAppiconName` key - the value is the icon file name located in `.xcassets` catalog with `AppIconExtension.appiconset` inside the extension folder.
48
48
49
-
4. Create the applicaiton group.
49
+
4. Create an application group.
50
50
51
-
In the common cases, the App Extensions will be used to pass/receive data and actions from and to your iOS application. In iOS to enable this functinality, both the application and the App Extension must be part of the same [**application group**](https://developer.apple.com/documentation/bundleresources/entitlements/com_apple_security_application-groups?language=objc).
51
+
In typical cases, the App Extensions are used to pass/receive data and actions from and to your iOS application. In iOS to enable this functionality, both the application and the App Extension must be part of the same [**application group**](https://developer.apple.com/documentation/bundleresources/entitlements/com_apple_security_application-groups?language=objc).
52
52
53
-
Example for creating same group for both the extension and the application
53
+
Example for creating the same group for both the extension and the application
54
54
55
55
- Create `TestExtension.entitlments` file inside `TestExtension` folder and add the specific group.
56
56
```plist
@@ -80,8 +80,8 @@ Example for creating same group for both the extension and the application
80
80
</plist>
81
81
```
82
82
83
-
5. Create a clean build (remove `platforms` folder) and you extension is good to go.
83
+
5. Create a clean build (remove `platforms` folder), and your extension is good to go.
84
84
85
-
Sample project demonstrating the above can be found here (**add link here**).
85
+
A sample project demonstrating the above can be found here (**add a link here**).
0 commit comments