FBInstrumentsClient.h

/*
 * Copyright (c) Meta Platforms, Inc. and affiliates.
 *
 * This source code is licensed under the MIT license found in the
 * LICENSE file in the root directory of this source tree.
 */

#import <Foundation/Foundation.h>

#import <FBControlCore/FBControlCore.h>

NS_ASSUME_NONNULL_BEGIN

@class FBAMDServiceConnection;
@class FBApplicationLaunchConfiguration;

/**
 A client for Instruments.
 */
@interface FBInstrumentsClient : NSObject

#pragma mark Initializers

/**
 Constructs a transport for the specified service connection.

 @param connection the connection to use.
 @param logger the logger to use.
 @return a Future that resolves with the instruments client.
 */
+ (FBFuture<FBInstrumentsClient *> *)instrumentsClientWithServiceConnection:(FBAMDServiceConnection *)connection logger:(id<FBControlCoreLogger>)logger;

#pragma mark Public Methods

/**
 Launches an application.

 @param configuration the app launch configuration.
 @return a Future that resolves with the pid of the app once it has launched.
 */
- (FBFuture<NSNumber *> *)launchApplication:(FBApplicationLaunchConfiguration *)configuration;

/**
 Kills an application

 @param processIdentifier the pid of the process to kill.
 @return a Future that resolves when killed.
 */
- (FBFuture<NSNull *> *)killProcess:(pid_t)processIdentifier;

@end

NS_ASSUME_NONNULL_END