BCS Autumn School. Distinguish your application with Bonjour. Nan Xu. 20 November 2013

Transcription

1 BCS Autumn School Distinguish your application with Bonjour Nan Xu 20 November 2013

2 About Speaker Director of Operations at Red7Mobile Ltd PRINCE2 project manager and Senior ios developer Have managed, developed and release 100+ apps for all platforms and many industry sectors.

3 Introduction Bonjour overview - why using Bonjour - ecosystem - Bonjour technology Code walkthrough Application demo Q&A

4 Why using Bonjour? Improve User Experience

5 Bonjour Ecosystem Platforms - Mac OS, ios, Windws, Linux and Android Devices - desktop/laptop - network printer and network camera - mobile phone - Apple TV Applications - itunes, iphoto, ichat, AirPrint - Safari on both Mac and windows - remote control, i.e Apple TV and Keynote

6 Bonjour Technology Link-local addressing - allocation IP addresses to hosts - IPv4 and IPv6 - handled by OS for software application Naming using Multicast DNS - using names to refer to hosts instead of IP addresses - handled by Bonjour for software application Note: if you build hardware, then you need to handle both addressing and naming yourself. DNS Service Discovery - using names to refer to hosts instead of IP addresses

7 Bonjour Service Name Bonjour service name contains three parts: 1. User-Visible Instance Name 2. Service Type (Application Protocol Name) 3. Domain Example: BSC Demo. _piano._tcp. local.

8 Service Types Service Type is a Unique Identifier String - contains max 15 characters in length - allows letters, digits and hyphens in US-ASCII encoding The identifier string describes: - what the service does - how to do it. i.e _keynotepairing._tcp IANA manages registry of unique service type strings - IANA list of assigned service type strings - applying for your own is easy and free - register your unique service type before releasing

9 Bonjour API Architecture NSNetService and NSNetServiceBrower in Foundation CFNetServices is parts of CFNetwork framework which is in Core Foundation DNS service discovery for Java is a OS X only API DNS Service discovery layer is built around BSD sockets Multicast DNS responder doesn t interact with developers software.

10 Bonjour API Architecture cont. How can your app plug into Bonjour framework

11 Bonjour API Architecture cont. TCP API will be used in each type of plug-in

12 Bonjour Operations Three basic operations. 1. Publishing (advertising a service) 2. Discovery (browsing for available services) 3. Resolution (translating service instance names to addresses and port numbers for use)

13 Bonjour Operations Server Side flow: Register and Publish Create TCP socket BSD fd (Socket/blind/listen) CFSocket Wrapped in CFSocket Create NSNetService NSNetService Ready to publish NSNetService (CFSocketCreateWithNative) (InitWithDomain:type:name:port) (publish)

14 Bonjour Operations Client Side flow: Browse (searchforserviceoftype:indomain:) NSNetServiceBrowser Found Service NSNetService (didfindservice:) Found Service NSNetService Found Service NSNetService Found Service NSNetService User Select Service Instance NSNetService

15 Bonjour Operations Final Resolve and Connect Client Side Connect NSInputStream Service Side Connect NSInputStream NSOutStream Connected NSOutStream Accept Callback NSNetService (getinputstream:outputstream) CFSocket

16 Code walkthrough Setup CFSocket CFSocketContext socketctxt = {0, self, NULL, NULL, NULL; CFSocketRef socket = CFSocketCreate(kCFAllocatorDefault, PF_INET6, SOCK_STREAM, IPPROTO_TCP, kcfsocketacceptcallback, (CFSocketCallBack)&TCPServerAcceptCallBack, &socketctxt); if (socket!= NULL) { protocolfamily = PF_INET6; else { socket = CFSocketCreate(kCFAllocatorDefault, PF_INET, SOCK_STREAM, IPPROTO_TCP, kcfsocketacceptcallback, (CFSocketCallBack)&TCPServerAcceptCallBack, &socketctxt); if (socket!= NULL) { protocolfamily = PF_INET; int yes = 1; setsockopt(cfsocketgetnative(socket), SOL_SOCKET, SO_REUSEADDR, (void *)&yes, sizeof(yes));

17 Code walkthrough Bind CFSocket with IPv6 BSD socket address if (protocolfamily == PF_INET6) { struct sockaddr_in6 addr6; memset(&addr6, 0, sizeof(addr6)); addr6.sin6_len = sizeof(addr6); addr6.sin6_family = AF_INET6; addr6.sin6_port = 0; addr6.sin6_flowinfo = 0; addr6.sin6_addr = in6addr_any; NSData *address6 = [NSData datawithbytes:&addr6 length:sizeof(addr6)]; if (kcfsocketsuccess!= CFSocketSetAddress(socket, (CFDataRef)address6)) { return NO; NSData *addr = [(NSData *)CFSocketCopyAddress(socket) autorelease]; memcpy(&addr6, [addr bytes], [addr length]); self.port = ntohs(addr6.sin6_port);

18 Code walkthrough Bind CFSocket with IPv6 BSD socket address if (protocolfamily == PF_INET4) { struct sockaddr_in addr4; memset(&addr4, 0, sizeof(addr4)); addr4.sin_len = sizeof(addr4); addr4.sin_family = AF_INET; addr4.sin_port = 0; addr4.sin_addr.s_addr = htonl(inaddr_any); NSData *address4 = [NSData datawithbytes:&addr4 length:sizeof(addr4)]; if (kcfsocketsuccess!= CFSocketSetAddress(socket, (CFDataRef)address4)) { return NO; NSData *addr = [(NSData *)CFSocketCopyAddress(socket) autorelease]; memcpy(&addr4, [addr bytes], [addr length]); self.port = ntohs(addr4.sin_port);

19 Code walkthrough Schedule sockets in Run loop CFRunLoopRef cfrl = CFRunLoopGetCurrent(); CFRunLoopSourceRef source = CFSocketCreateRunLoopSource(kCFAllocatorDefault, socket, 0); CFRunLoopAddSource(cfrl, source, kcfrunloopcommonmodes); CFRelease(source);

20 Code walkthrough Register and Publish Bonjour NSNetService *netservice = [[NSNetService alloc] initwithdomain:@ _local. type:@ _piano._tcp name:@ BCS Demo port:self.port]; if(netservice == nil) return NO; [netservice setdelegate:self]; [netservice scheduleinrunloop:[nsrunloop currentrunloop] formode:nsrunloopcommonmodes]; [netservice publish]; NSNetServices Delegate Methods - (void)netservicedidpublish:(nsnetservice *)sender { - (void)netservice:(nsnetservice *)sender didnotpublish:(nsdictionary *)errordict {

21 Code walkthrough Browse for Bonjour Services NSNetServiceBrowser *netservicebroswer = [[NSNetServiceBrowser alloc] init]; [netservicebroswer setdelegate:self]; [self.netservicebrowser searchforservicesoftype :@ _piano._tcp indomain :@ _local. ]; NSNetServiceBrowser Delegate Methods - (void)netservicebrowser:(nsnetservicebrowser *)netservicebrowser didfindservice:(nsnetservice *)service morecoming:(bool)morecoming { // If a service came online, add it to the list and update the table view if no more events are queued. [self.avaiableservices addobject:service]; // If morecoming is NO, it means that there are no more messages in the queue from the Bonjour daemon, so we should now try to connect. if (!morecoming) { if (self.delegate && [self.delegate respondstoselector:@selector(bonjourdidfindservices:)]) { [self.delegate bonjourdidfindservices:self.avaiableservices];

22 Code walkthrough Resolve and Connect Bonjour Service NSNetService *netservice = selectedservice; netservice.delegate = self; // Attempt to resolve the service. A value of 0.0 sets an unlimited time to resolve it. [netservice resolvewithtimeout:0.0]; NSNetService Delegate Methods for Resolving - (void)netservicedidresolveaddress:(nsnetservice *)service { NSInputStream *istream; NSOutputStream *ostream; if (![service getinputstream:&istream outputstream:&ostream]) { NSLog(@"Cannot get Input and Output streams for service: %@", service); return; [self.listernerchannel openinputstream:istream outputstream:ostream delegate:self]; - (void)netservice:(nsnetservice *)sender didnotresolve:(nsdictionary *)errordict {

23 Bonjour Channel Object Code walkthrough - (void)openinputstream:(nsinputstream *)istream outputstream:(nsoutputstream *)ostream delegate:(id)delegate { self.inputstream = istream; self.inputstream.delegate = delegate; [self.inputstream scheduleinrunloop:[nsrunloop currentrunloop] formode:nsdefaultrunloopmode]; [self.inputstream open]; self.outputstream = ostream; self.outputstream.delegate = delegate; [self.outputstream scheduleinrunloop:[nsrunloop currentrunloop] formode:nsdefaultrunloopmode]; [self.outputstream open];

24 Put Everything Together BCSBonjourObject - netservice - netservicebrower BCSBonjour Delegate methods BCSBonjourBroadcast - tcpserver - channearray BCSBonjourListener - channel - socket - port - netservice TCPServer BCSBonjourChannel - inputstream - outputstream TCPServer Delegate methods

25 Application Demo

26 Reference and Further Reading Bonjour for Developers Simplify Networking with Bonjour (WWDC 2012) Bonjour Overview (Wikipedia) Zero Configuration Networking (Book)

27 Thank you for listening Nan Xu Director of Operations Josh Regan Senior Mobile Developer