1. Create a new SSH key and name it `id_tecnavia_deploy_key`, put the key files in folder `~/.ssh/`(see this article for reference https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent). Then, in order to be able to download the software from Tecnavia repository, you should provide to Tecnavia your public key.
2. Edit your SSH config file `~/.ssh/config` and add the following lines:
```
#GitHub Tecnavia Repo
Host tecnavia-repo-sdk
HostName github.com
AddKeysToAgent yes
PreferredAuthentications publickey
IdentityFile ~/.ssh/id_tecnavia_deploy_key
```
3. Add the following lines inside your target declaration in your `Podfile`.
Tecnavia provides you a zip package named `ta-newsmemory-sdk_XYZ`, where XYZ stands for the package version (ex. 31702, means that the SDK version is 3.17.02).
Tecnavia provides you a zip package named `ta-newsmemory-sdk_XYZ`, where XYZ stands for the package version (ex. 31702, means that the SDK version is 3.17.02).
Unzip the package and copy the `ta-newsmemory-sdk_XYZ` folder in the folder containing your project's `.xcodeproj` file (i.e. the SDK folder must be at the same level of the project file).
The unzipped folder named `ta-newsmemory-sdk_XYZ` has the following subfolders structure:
```
.
├── Headers # headers files imported by the .xcconfig file
├── Libraries # libraries imported by the .xcconfig file
├── Device # arm64 libraries
├── Simulator # simulator x86_64 libraries
├── Other # images and resources to manully import in the project
├── assets # set of default icons/images used by the ePaper
├── Resources
├── fonts # set of base fonts supported by the ePaper (*.otf, *.ttf files)
├── Newsmemory.js # the minified javascript bundle file, core of Tecnavia ePaper solution
├── AccessibilityResources.bundle # a bundle required by React Native framework
├── ta-newsmemory-sdk.debug.xcconfig # the .xcconfig file with debug settings
├── ta-newsmemory-sdk.release.xcconfig # the .xcconfig file with release settings
├── LICENSE
└── README.md
└── img # set of images for the README file
```
---
1. Drag the `assets` inside `Other` folder and drop it in the project navigator.
2. Select `'Create folder references'` option
3. Drag the `Resources` inside `Other` folder and drop it in the project navigator.
4. Select `'Create groups'` option
5. Drag and drop `ta-newsmemory-sdk.debug.xcconfig` and `ta-newsmemory-sdk.release.xcconfig` in the project navigator
6. Select `'Create groups'` option
7. Select your project in the project navigator and select `Info`
8. Under `Configurations` expand the `Debug` line and select your Target
9. Click on `None` and select `ta-newsmemory-sdk.debug.xcconfig`
10. Do the same for the `Release` configuration this time selecting the `ta-newsmemory-sdk.release.xcconfig` configuration file.
11. if your project already includes a `.xcconfig` file for your target configuration add this line at the end of the file
- your-debug-xconfig-file.xcconfig
```
...
#include "ta-newsmemory-sdk.debug.xcconfig"
```
- your-release-xconfig-file.xcconfig
```
...
#include "ta-newsmemory-sdk.release.xcconfig"
```
---
<aname="changes"></a>
## Changes to the Info.plist
### Fonts
In order to make ePaper fonts available inside your app you'll need to add the font file name lines to your app's `Info.plist`.
The key were to add the font names is `UIAppFonts`
```
<key>UIAppFonts</key>
<array>
<string>Roboto_medium.ttf</string>
<string>Roboto.ttf</string>
<string>rubicon-icon-font.ttf</string>
<string>Merriweather-Bold.otf</string>
<string>Merriweather-Light.otf</string>
<string>Merriweather-Regular.otf</string>
<string>OpenSans-Bold.ttf</string>
<string>OpenSans-Light.ttf</string>
<string>OpenSans-Regular.ttf</string>
<string>DroidKufi-Bold.ttf</string>
<string>DroidKufi-Regular.ttf</string>
<string>AntDesign.ttf</string>
<string>Entypo.ttf</string>
<string>EvilIcons.ttf</string>
<string>Feather.ttf</string>
<string>FontAwesome.ttf</string>
<string>FontAwesome5_Brands.ttf</string>
<string>FontAwesome5_Regular.ttf</string>
<string>FontAwesome5_Solid.ttf</string>
<string>Fontisto.ttf</string>
<string>Foundation.ttf</string>
<string>Ionicons.ttf</string>
<string>MaterialCommunityIcons.ttf</string>
<string>MaterialIcons.ttf</string>
<string>Octicons.ttf</string>
<string>SimpleLineIcons.ttf</string>
<string>Zocial.ttf</string>
<string>Nunito-Bold.ttf</string>
<string>Nunito-Medium.ttf</string>
<string>Nunito-Regular.ttf</string>
<string>Nunito-Light.ttf</string>
</array>
```
### Other Info.plist values
The ePaper usually works with the key `UIViewControllerBasedStatusBarAppearance` set to `NO`
If your app requires `UIViewControllerBasedStatusBarAppearance` to be `YES` ensure that your View Controller sets the Status bar style to `.lightContent`, as the default background color for the ePaper is `black`.
```
override var preferredStatusBarStyle: UIStatusBarStyle {
return .lightContent
}
```
### HTTP support
If your ePaper app needs to load resources from non-HTTPS domains ensure that the Info.plist allows arbitrary loads:
```
<key>NSAppTransportSecurity</key>
<dict>
<key>NSAllowsArbitraryLoads</key>
<true/>
...
</dict>
```
---
<aname="integration"></a>
## Code integration
### Setup
Tecnavia provides also the couple "PAPER_SETUP" - "SERVER" which allows you to load the epaper for a specific publication.
Before displaying the ePaper View Controller (ex. during the your app setup), call the `Newsmemory` singleton to set the startup parameters.
2. Make the class that will control the ePaper implement the `NewsmemoryDelegate` interface (the below code shows how you could do it in the `AppDelegate.h`).
`IMPORTANT:` make sure that the class has a `window` property.
3. Before loading the ePaper view (e.g. you could put in your `didFinishLaunchingWithOptions` method in your `AppDelegate.m`), set the publication parameters provided (i.e. PAPER_SETUP, SERVER and API_KEY) and set the delegate
# Make frameworks in the list static frameworks by overriding the static_framework?function to return true
pre_install do |installer|
installer.pod_targets.each do |pod|
if static_libraries.include?(pod.name)
puts "Overriding the static_framework? method for #{pod.name}"
def pod.static_framework?;
true
end
def pod.build_type;
Pod::BuildType.static_library
end
end
end
end
```
2. run again `pod install`
3. Add to you project a `-Bridging-Header.h` file and add there the import of the `Newsmemory` module:
```
#import <Newsmemory/Newsmemory.h>
```
4. Remove the import of the `Newsmemory` module from your `.swift` files
~~import Newsmemory~~
5. Go to `Project`-> `Build Settings`-> `Objective-C Bridging Header` and add the path to the bridging header file. The path should be relative to your project, similar to the way your Info.plist path is specified in Build Settings (see https://developer.apple.com/documentation/swift/importing-objective-c-into-swift for more details).
| setPSetup | NSString\* | (required) | the configuration to load for a publication |
| setServer | NSString\* | (required) | the Tecnavia endpoint for the publication |
| setAPIKey | NSString\* | none | the API key to use the SDK at runtime |
| setToken | NSString\* | none | the auto login token to pass the ePaper |
| setLockedOrientation | NSString\* | none | the orientation the SDK should support, possible values (`all`, `portrait`, `portrait_up`, `portrait_down`, `landscape`, `landscape_left`, `landscape_right`) |
| setLockedOrientationDevice | NSString\* | none | the device type that should respect the locked orientation setting (see setLockedOrientation). Possible values (`phone`, `tablet`). If not set, locked orientation (if set) will be applied to both phones and tablets. |
| setDelegate | delegate | none | pass the object that will implement the supported method [callbacks](#callbacks) |
| setNeedsCloseButton | BOOL | `NO` | adds a button to the ePaper buttons bar to send to the enclosing app a message to close the ePaper |
| setNeedsSafeArea | BOOL | `NO` | delegates to the SDK the handling of the device safe area |
| setDebugMode | BOOL | `NO` | enables debug mode to increase logging and use development backend versions, it must be set to `NO` when building for Release |
| enableDebugger | BOOL | `NO` | enables a visual debugger to monitor performances and use development backend versions, it must be set to `NO` when building for Release |
| newsmemoryWillOpenURL | (NSString\*)url | BOOL | `YES` | This callback if called when the ePaper tries to open an URL, if this method returns `NO` the URL will be opened inside the Tecnavia ePaper solution, if the method returns `YES` the ePaper won't open the URL and the enclosing app should manage the opening itself. `IMPORTANT:` As this is a synchronous method if the decision can be made within 2 seconds the ePaper will open the URL internally. |
| onNewsmemoryTrackAction | (NSDictionary \*)data | none | `NO` | Each action/event in the app will cause this callback to be called. The data dictionary contains the info regarding the user action. This callback can be used to collect data and send it to the analytics platform your app uses. For more details about the data sent by the app see paragraph [Tracking](#tracking) |
| onNewsmemoryReload | none | none | `NO` | This callback is invoked when a JS bundle update takes place in the SDK |
| onNewsmemoryTokenExpired| none | none | `YES` | This callback is invoked when the SDK login API call fails due to the expiration of the TOKEN. If this method returns `NO` the login process will be handled inside the Tecnavia ePaper solution, if the method returns `YES` the ePaper won't continue loading: the enclosing app should manage the login process itself and eventually relaunch the SDK. `IMPORTANT:` As this is a synchronous method if the decision can't be made within 2 seconds the ePaper will handle the login internally. |
| article_id | int | the Tecnavia id of the article, ex: `8` |
### Event specific data
An `event` represents an action performed by the user on the ePaper, such as the activation of the Text-to-speech feature or the sharing of an article on Facebook.
The `data` dictionary can contain the following values:
#### - `error build: Library not found for -l<LIBRARY NAME>` at build stage
Check that you copied the SDK folder in the same folder of your `.xcodeproj` file.
Check that you imported the `.xcconfig` file in your project `Configurations` settings
#### - `[native] No bundle URL present. Make sure you're running a packager server or have included a .jsbundle file in your application bundle.` in the logs and crash at runtime
Ensure that the you imported the file `Newsmemory.js` within the SDK resources (see `Installation` step `4`).
#### - `rpath/libswiftCore.dylib not loaded` at runtime
This might mean that xCode is not including the required Swift packages.
To fix simply add a blank .swift file and let xCode generate the corresponding bridging header.
#### - `CocoaPods could not find compatible versions for pod "NewsmemorySDK"` when running `pod install`
```
[!] CocoaPods could not find compatible versions for pod "NewsmemorySDK":
