Remote Logging

Beta release

Sauce Labs Mobile App Distribution allows developers to log items with a session without logging into the console output. In some cases, workarounds allow you to wrap the Sauce Labs Mobile App Distribution remote logging method in a way that both log to the console and the session.

Android

TestFairy.log("<tag>", "<message>");

Example

// Be sure to import the SDK
import com.testfairy.TestFairy;

TestFairy.log("Tag", "Hello, Sauce Labs Mobile App Distribution!");

iOS Objective C

TFLog(@"<message with format>", <arguments>);
[TestFairy log:@"<message>"];

Example

// Be sure to import the SDK
#import "TestFairy.h"

TFLog(@"Hello, %@", @"Sauce Labs Mobile App Distribution!");
[TestFairy log:@"Hello, Sauce Labs Mobile App Distribution!"];

We recommend sending all calls to NSLog to the SDK so you can continue to use NSLog and see all your log statements in your session.
To enable this, you have to redefine NSLog using a macro with the following lines. This macro allows you to continue using NSLog in your code while also adding the logs to the matching session in Sauce Labs Mobile App Distribution).

Changing Your Prefix Header

#import "TestFairy.h"
#define NSLog(s, ...) do { NSLog(s, ##__VA_ARGS__); TFLog(s, ##__VA_ARGS__); } while (0)

1. Add the above line to a global header in your project, accessible to every class file.
2. Update or create a Prefix Header (.pch) for your project. If you do not have a PCH file in your project, you can follow the steps in the next section.

Creating a New Prefix Header

If your project doesn’t already include a Prefix Header (.pch):

1. Create a new file under iOS > Other > PCH File.
2. Name your file PCH file.
3. Add these lines of code to the file:

#import "TestFairy.h"
#define NSLog(s, ...) do { NSLog(s, ##__VA_ARGS__); TFLog(s, ##__VA_ARGS__); } while (0)

4. From the Project Navigator, select your project and the corresponding target.
5. Project > Build Settings > Search: "Prefix Header".
6. Under the compiler settings group, you get the Prefix Header key.
7. Type the file's path, for example: $(SRCROOT)/$(PROJECT_NAME)/ProjectName-Prefix.pch. Your file may be at a different location.
8. Make sure the option Precompile Prefix Header is set to YES.
9. Clean your project, and rebuild.

iOS Swift

TestFairy.log("<message>")

Example

// Be sure to import the SDK
import TestFairy

TestFairy.log("Hello, Sauce Labs Mobile App Distribution!")

To forward existing print or NSLog output as well, call TestFairy.log from your logging helper. The Objective-C NSLog macro approach in the Objective C tab does not apply to Swift print.

React Native

TestFairy.log("<message>");

Example

// Be sure to import the SDK
import TestFairy from '@saucelabs/mobile-beta-react-native';

TestFairy.log("Hello, Sauce Labs Mobile App Distribution!");

Objects passed to log are serialized to JSON before they are sent.