The SDLFileManager is an RPC manager for the remote file system. After it starts, it will attempt to communicate with the remote file system to get the names of all files. Deleting and Uploading will them queue these changes as transactions. If a delete succeeds, the local list of remote files will remove that file name, and likewise, if an upload succeeds, the local list of remote files will now include that file name.
A set of all names of files known on the remote head unit. Known files can be used or deleted on the remote system.
@property (readonly, copy, nonatomic)
NSSet<SDLFileName *> *_Nonnull remoteFileNames;var remoteFileNames: SetThe number of bytes still available for files for this app.
@property (readonly, assign, nonatomic) NSUInteger bytesAvailable;var bytesAvailable: UInt { get }The state of the file manager.
@property (readonly, copy, nonatomic) NSString *_Nonnull currentState;var currentState: String { get }The currently pending transactions (Upload, Delete, and List Files) in the file manager
@property (readonly, copy, nonatomic)
NSArray<__kindof NSOperation *> *_Nonnull pendingTransactions;var pendingTransactions: [Operation] { get }Whether or not the file manager is suspended. If suspended, the file manager can continue to queue uploads and deletes, but will not actually perform any of those until it is no longer suspended. This can be used for throttling down the file manager if other, important operations are taking place over the accessory connection.
@property (assign, readwrite, nonatomic) BOOL suspended;var suspended: Bool { get set }Initialize the class…or not, since this method is unavailable. Dependencies must be injected using initWithConnectionManager:
- (nonnull instancetype)init;nil
Creates a new file manager with a specified connection manager
- (nonnull instancetype)initWithConnectionManager:
(nonnull id<SDLConnectionManagerType>)manager;A connection manager to use to forward on RPCs
An instance of SDLFileManager
The manager stars up and attempts to fetch its initial list and transfer initial files.
- (void)startWithCompletionHandler:
(nullable SDLFileManagerStartupCompletionHandler)completionHandler;func start(completionHandler: SDLFileManagerStartupCompletionHandler? = nil)The handler called when the manager is set up or failed to set up with an error. Use weak self when accessing self from the completion handler.
Cancels all file manager operations and deletes all associated data.
- (void)stop;func stop()Delete a file stored on the remote system
- (void)deleteRemoteFileWithName:(nonnull SDLFileName *)name
completionHandler:
(nullable SDLFileManagerDeleteCompletionHandler)completion;func deleteRemoteFile(withName name: String, completionHandler completion: SDLFileManagerDeleteCompletionHandler? = nil)The name of the remote file. It should be a name currently stored in remoteFileNames
An optional completion handler that sends an error should one occur.
Upload a file to the remote file system. If a file with the [SDLFile name] already exists, this will overwrite that file. If you do not want that to happen, check remoteFileNames before uploading, or change allowOverwrite to NO.
- (void)uploadFile:(nonnull SDLFile *)file
completionHandler:
(nullable SDLFileManagerUploadCompletionHandler)completion;func uploadFile(_ file: SDLFile, completionHandler completion: SDLFileManagerUploadCompletionHandler? = nil)An SDLFile that contains metadata about the file to be sent
An optional completion handler that sends an error should one occur.
A URL to the directory where temporary files are stored. When an SDLFile is created with NSData, it writes to a temporary file until the file manager finishes uploading it.
The SDL library manages the creation and deletion of these files and you should not have to touch this directory at all.
+ (nonnull NSURL *)temporaryFileDirectory;class func temporaryFileDirectory() -> URLAn NSURL pointing to the location on disk where SDL’s temporary files are stored.