WebimClientLibraryWrapper

Objective-C-friendly wrapper around WebimClientLibrary 3.

Installation

For the first you should have WebimClientLibrary inside your project.

Then just copy .swift-files from WebimClientLibraryWrapper directory to your Objective-C-based project (in alphabetical order):

• Department.swift
• FatalErrorHandler.swift,
• Message.swift,
• MessageListener.swift,
• MessageStream.swift,
• MessageTracker.swit,
• Operator.swift,
• ProvidedAuthorizationTokenStateListener.swift
• Webim.swift,
• WebimError.swift,
• WebimLogger.swift,
• WebimRemoteNotification.swift,
• WebimSession.swift.

If your project doesn't contain any .swift-files yet Xcode (or another IDE you use) may offer to create a bridging header file. Do not hesitate to agree. More details about "Swift and Objective-C in the Same Project" can be found at Apple Developer portal.

Inside an Objective-C-file in which you are intended to use WebimClientLibrary you have to import just "<Your_Project_Name>-Swift.h" (do not try to import nor WebimClientLibrary, neither WebimClientLibraryWrapper files!).

That's it! You are ready to start using WebimClientLibrary inside your Objective-C code!

Example

Provided example is not a working application. It's just a basic sample project to show how WebimClientLibraryWrapper can be integrated into your app.

Version

Every version of WebimClientLibraryWrapper matches with appropriate WebimClientLibrary version. Different versions may have differences in classes and methods naming or do not have some of functionality.

Usage

Basically there's no need to take a look inside WebimClientLibraryWrapper files. In the most cases it is sufficient to work just with WebimClientLibrary APIs.

Class and methods names that should be used are similar to API names. E.g. to create session this code may be used:

WebimSession *webimSession = [[[[Webim newSessionBuilder]
    setAccountName:@"ACCOUNT_NAME"]
    setLocation:@"LOCATION"]
    build:&error];

Original API version is:

let webimSession = try Webim.newSessionBuilder()
    .set(accountName: "ACCOUNT_NAME")
    .set(location: "LOCATION_NAME")
    .build()

Another example is resuming session:

[webimSession resume:&error];

Instead of this Swift synthax:

try webimSession.resume()

And one more:

MessageStream *messageStream = [webimSession getStream];

Instead of:

let messageStream = webimSession.getStream()

Simple! And obvious.

Of course there're many differences between Swift and Objective-C languages, so some of the features are presented differently. The most notable othernesses in this context are optionals and error handling.

If this wrapper implementation seems not comfortable to you, go on, feel free to change wrapper files at your decision. This code is just an instrument.

License

WebimClientLibraryWrapper is available under the MIT license. See the LICENSE file for more info.