iOS Team / CNLiveChatManagerSDKDemo · Commits

Commit 124963045ddf2989c6df437dd88627be982cf55a

Authored by 王军波
1 parent b6c7dfc7

no message

Inline Side-by-side
Showing 33 changed files with 0 additions and 4664 deletions

Too many changes to show.
Reload with full diff Plain diff Email patch

To preserve performance only 33 of 217 files are displayed.

CNLiveXMPPManagerDemo/CNLiveXMPPManagerDemo.xcodeproj/project.pbxproj deleted 100644 → 0
  View file @b6c7dfc
1   -// !$*UTF8*$!
2   -{
3   - archiveVersion = 1;
4   - classes = {
5   - };
6   - objectVersion = 46;
7   - objects = {
8   -
9   -/* Begin PBXBuildFile section */
10   - 326B73AA1E03A66000F21637 /* CNLiveXMPPSDK.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 326B73A81E03A65C00F21637 /* CNLiveXMPPSDK.framework */; };
11   - 326B73AB1E03A66000F21637 /* CNLiveXMPPSDK.framework in Embed Frameworks */ = {isa = PBXBuildFile; fileRef = 326B73A81E03A65C00F21637 /* CNLiveXMPPSDK.framework */; settings = {ATTRIBUTES = (CodeSignOnCopy, RemoveHeadersOnCopy, ); }; };
12   - 327977C31D9BBF1D00679858 /* main.m in Sources */ = {isa = PBXBuildFile; fileRef = 327977C21D9BBF1D00679858 /* main.m */; };
13   - 327977C61D9BBF1D00679858 /* AppDelegate.m in Sources */ = {isa = PBXBuildFile; fileRef = 327977C51D9BBF1D00679858 /* AppDelegate.m */; };
14   - 327977C91D9BBF1D00679858 /* ViewController.m in Sources */ = {isa = PBXBuildFile; fileRef = 327977C81D9BBF1D00679858 /* ViewController.m */; };
15   - 327977CC1D9BBF1D00679858 /* Main.storyboard in Resources */ = {isa = PBXBuildFile; fileRef = 327977CA1D9BBF1D00679858 /* Main.storyboard */; };
16   - 327977CE1D9BBF1D00679858 /* Assets.xcassets in Resources */ = {isa = PBXBuildFile; fileRef = 327977CD1D9BBF1D00679858 /* Assets.xcassets */; };
17   - 327977D11D9BBF1D00679858 /* LaunchScreen.storyboard in Resources */ = {isa = PBXBuildFile; fileRef = 327977CF1D9BBF1D00679858 /* LaunchScreen.storyboard */; };
18   - 327977E41D9BBF7200679858 /* CocoaAsyncSocket.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 327977D91D9BBF6100679858 /* CocoaAsyncSocket.framework */; };
19   - 327977E51D9BBF7200679858 /* CocoaAsyncSocket.framework in Embed Frameworks */ = {isa = PBXBuildFile; fileRef = 327977D91D9BBF6100679858 /* CocoaAsyncSocket.framework */; settings = {ATTRIBUTES = (CodeSignOnCopy, RemoveHeadersOnCopy, ); }; };
20   - 327977E61D9BBF7200679858 /* CocoaLumberjack.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 327977DA1D9BBF6100679858 /* CocoaLumberjack.framework */; };
21   - 327977E71D9BBF7200679858 /* CocoaLumberjack.framework in Embed Frameworks */ = {isa = PBXBuildFile; fileRef = 327977DA1D9BBF6100679858 /* CocoaLumberjack.framework */; settings = {ATTRIBUTES = (CodeSignOnCopy, RemoveHeadersOnCopy, ); }; };
22   - 327977E81D9BBF7200679858 /* KissXML.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 327977DB1D9BBF6100679858 /* KissXML.framework */; };
23   - 327977E91D9BBF7200679858 /* KissXML.framework in Embed Frameworks */ = {isa = PBXBuildFile; fileRef = 327977DB1D9BBF6100679858 /* KissXML.framework */; settings = {ATTRIBUTES = (CodeSignOnCopy, RemoveHeadersOnCopy, ); }; };
24   - 327977EA1D9BBF7200679858 /* XMPPFramework.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 327977DC1D9BBF6100679858 /* XMPPFramework.framework */; };
25   - 327977EB1D9BBF7200679858 /* XMPPFramework.framework in Embed Frameworks */ = {isa = PBXBuildFile; fileRef = 327977DC1D9BBF6100679858 /* XMPPFramework.framework */; settings = {ATTRIBUTES = (CodeSignOnCopy, RemoveHeadersOnCopy, ); }; };
26   -/* End PBXBuildFile section */
27   -
28   -/* Begin PBXCopyFilesBuildPhase section */
29   - 327977EC1D9BBF7200679858 /* Embed Frameworks */ = {
30   - isa = PBXCopyFilesBuildPhase;
31   - buildActionMask = 2147483647;
32   - dstPath = "";
33   - dstSubfolderSpec = 10;
34   - files = (
35   - 327977E91D9BBF7200679858 /* KissXML.framework in Embed Frameworks */,
36   - 326B73AB1E03A66000F21637 /* CNLiveXMPPSDK.framework in Embed Frameworks */,
37   - 327977E51D9BBF7200679858 /* CocoaAsyncSocket.framework in Embed Frameworks */,
38   - 327977E71D9BBF7200679858 /* CocoaLumberjack.framework in Embed Frameworks */,
39   - 327977EB1D9BBF7200679858 /* XMPPFramework.framework in Embed Frameworks */,
40   - );
41   - name = "Embed Frameworks";
42   - runOnlyForDeploymentPostprocessing = 0;
43   - };
44   -/* End PBXCopyFilesBuildPhase section */
45   -
46   -/* Begin PBXFileReference section */
47   - 326B73A81E03A65C00F21637 /* CNLiveXMPPSDK.framework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.framework; path = CNLiveXMPPSDK.framework; sourceTree = "<group>"; };
48   - 327977BE1D9BBF1D00679858 /* CNLiveXMPPManagerDemo.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = CNLiveXMPPManagerDemo.app; sourceTree = BUILT_PRODUCTS_DIR; };
49   - 327977C21D9BBF1D00679858 /* main.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = main.m; sourceTree = "<group>"; };
50   - 327977C41D9BBF1D00679858 /* AppDelegate.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = AppDelegate.h; sourceTree = "<group>"; };
51   - 327977C51D9BBF1D00679858 /* AppDelegate.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = AppDelegate.m; sourceTree = "<group>"; };
52   - 327977C71D9BBF1D00679858 /* ViewController.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = ViewController.h; sourceTree = "<group>"; };
53   - 327977C81D9BBF1D00679858 /* ViewController.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = ViewController.m; sourceTree = "<group>"; };
54   - 327977CB1D9BBF1D00679858 /* Base */ = {isa = PBXFileReference; lastKnownFileType = file.storyboard; name = Base; path = Base.lproj/Main.storyboard; sourceTree = "<group>"; };
55   - 327977CD1D9BBF1D00679858 /* Assets.xcassets */ = {isa = PBXFileReference; lastKnownFileType = folder.assetcatalog; path = Assets.xcassets; sourceTree = "<group>"; };
56   - 327977D01D9BBF1D00679858 /* Base */ = {isa = PBXFileReference; lastKnownFileType = file.storyboard; name = Base; path = Base.lproj/LaunchScreen.storyboard; sourceTree = "<group>"; };
57   - 327977D21D9BBF1D00679858 /* Info.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; path = Info.plist; sourceTree = "<group>"; };
58   - 327977D91D9BBF6100679858 /* CocoaAsyncSocket.framework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.framework; path = CocoaAsyncSocket.framework; sourceTree = "<group>"; };
59   - 327977DA1D9BBF6100679858 /* CocoaLumberjack.framework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.framework; path = CocoaLumberjack.framework; sourceTree = "<group>"; };
60   - 327977DB1D9BBF6100679858 /* KissXML.framework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.framework; path = KissXML.framework; sourceTree = "<group>"; };
61   - 327977DC1D9BBF6100679858 /* XMPPFramework.framework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.framework; path = XMPPFramework.framework; sourceTree = "<group>"; };
62   -/* End PBXFileReference section */
63   -
64   -/* Begin PBXFrameworksBuildPhase section */
65   - 327977BB1D9BBF1D00679858 /* Frameworks */ = {
66   - isa = PBXFrameworksBuildPhase;
67   - buildActionMask = 2147483647;
68   - files = (
69   - 327977E81D9BBF7200679858 /* KissXML.framework in Frameworks */,
70   - 327977E41D9BBF7200679858 /* CocoaAsyncSocket.framework in Frameworks */,
71   - 326B73AA1E03A66000F21637 /* CNLiveXMPPSDK.framework in Frameworks */,
72   - 327977E61D9BBF7200679858 /* CocoaLumberjack.framework in Frameworks */,
73   - 327977EA1D9BBF7200679858 /* XMPPFramework.framework in Frameworks */,
74   - );
75   - runOnlyForDeploymentPostprocessing = 0;
76   - };
77   -/* End PBXFrameworksBuildPhase section */
78   -
79   -/* Begin PBXGroup section */
80   - 327977B51D9BBF1D00679858 = {
81   - isa = PBXGroup;
82   - children = (
83   - 326B73A81E03A65C00F21637 /* CNLiveXMPPSDK.framework */,
84   - 327977D91D9BBF6100679858 /* CocoaAsyncSocket.framework */,
85   - 327977DA1D9BBF6100679858 /* CocoaLumberjack.framework */,
86   - 327977DB1D9BBF6100679858 /* KissXML.framework */,
87   - 327977DC1D9BBF6100679858 /* XMPPFramework.framework */,
88   - 327977C01D9BBF1D00679858 /* CNLiveXMPPManagerDemo */,
89   - 327977BF1D9BBF1D00679858 /* Products */,
90   - );
91   - sourceTree = "<group>";
92   - };
93   - 327977BF1D9BBF1D00679858 /* Products */ = {
94   - isa = PBXGroup;
95   - children = (
96   - 327977BE1D9BBF1D00679858 /* CNLiveXMPPManagerDemo.app */,
97   - );
98   - name = Products;
99   - sourceTree = "<group>";
100   - };
101   - 327977C01D9BBF1D00679858 /* CNLiveXMPPManagerDemo */ = {
102   - isa = PBXGroup;
103   - children = (
104   - 327977C41D9BBF1D00679858 /* AppDelegate.h */,
105   - 327977C51D9BBF1D00679858 /* AppDelegate.m */,
106   - 327977C71D9BBF1D00679858 /* ViewController.h */,
107   - 327977C81D9BBF1D00679858 /* ViewController.m */,
108   - 327977CA1D9BBF1D00679858 /* Main.storyboard */,
109   - 327977CD1D9BBF1D00679858 /* Assets.xcassets */,
110   - 327977CF1D9BBF1D00679858 /* LaunchScreen.storyboard */,
111   - 327977D21D9BBF1D00679858 /* Info.plist */,
112   - 327977C11D9BBF1D00679858 /* Supporting Files */,
113   - );
114   - path = CNLiveXMPPManagerDemo;
115   - sourceTree = "<group>";
116   - };
117   - 327977C11D9BBF1D00679858 /* Supporting Files */ = {
118   - isa = PBXGroup;
119   - children = (
120   - 327977C21D9BBF1D00679858 /* main.m */,
121   - );
122   - name = "Supporting Files";
123   - sourceTree = "<group>";
124   - };
125   -/* End PBXGroup section */
126   -
127   -/* Begin PBXNativeTarget section */
128   - 327977BD1D9BBF1D00679858 /* CNLiveXMPPManagerDemo */ = {
129   - isa = PBXNativeTarget;
130   - buildConfigurationList = 327977D51D9BBF1D00679858 /* Build configuration list for PBXNativeTarget "CNLiveXMPPManagerDemo" */;
131   - buildPhases = (
132   - 327977BA1D9BBF1D00679858 /* Sources */,
133   - 327977BB1D9BBF1D00679858 /* Frameworks */,
134   - 327977BC1D9BBF1D00679858 /* Resources */,
135   - 327977EC1D9BBF7200679858 /* Embed Frameworks */,
136   - );
137   - buildRules = (
138   - );
139   - dependencies = (
140   - );
141   - name = CNLiveXMPPManagerDemo;
142   - productName = CNLiveXMPPManagerDemo;
143   - productReference = 327977BE1D9BBF1D00679858 /* CNLiveXMPPManagerDemo.app */;
144   - productType = "com.apple.product-type.application";
145   - };
146   -/* End PBXNativeTarget section */
147   -
148   -/* Begin PBXProject section */
149   - 327977B61D9BBF1D00679858 /* Project object */ = {
150   - isa = PBXProject;
151   - attributes = {
152   - LastUpgradeCheck = 0800;
153   - ORGANIZATIONNAME = "雷浩杰";
154   - TargetAttributes = {
155   - 327977BD1D9BBF1D00679858 = {
156   - CreatedOnToolsVersion = 8.0;
157   - DevelopmentTeam = 94X49GG3ZW;
158   - ProvisioningStyle = Automatic;
159   - };
160   - };
161   - };
162   - buildConfigurationList = 327977B91D9BBF1D00679858 /* Build configuration list for PBXProject "CNLiveXMPPManagerDemo" */;
163   - compatibilityVersion = "Xcode 3.2";
164   - developmentRegion = English;
165   - hasScannedForEncodings = 0;
166   - knownRegions = (
167   - en,
168   - Base,
169   - );
170   - mainGroup = 327977B51D9BBF1D00679858;
171   - productRefGroup = 327977BF1D9BBF1D00679858 /* Products */;
172   - projectDirPath = "";
173   - projectRoot = "";
174   - targets = (
175   - 327977BD1D9BBF1D00679858 /* CNLiveXMPPManagerDemo */,
176   - );
177   - };
178   -/* End PBXProject section */
179   -
180   -/* Begin PBXResourcesBuildPhase section */
181   - 327977BC1D9BBF1D00679858 /* Resources */ = {
182   - isa = PBXResourcesBuildPhase;
183   - buildActionMask = 2147483647;
184   - files = (
185   - 327977D11D9BBF1D00679858 /* LaunchScreen.storyboard in Resources */,
186   - 327977CE1D9BBF1D00679858 /* Assets.xcassets in Resources */,
187   - 327977CC1D9BBF1D00679858 /* Main.storyboard in Resources */,
188   - );
189   - runOnlyForDeploymentPostprocessing = 0;
190   - };
191   -/* End PBXResourcesBuildPhase section */
192   -
193   -/* Begin PBXSourcesBuildPhase section */
194   - 327977BA1D9BBF1D00679858 /* Sources */ = {
195   - isa = PBXSourcesBuildPhase;
196   - buildActionMask = 2147483647;
197   - files = (
198   - 327977C91D9BBF1D00679858 /* ViewController.m in Sources */,
199   - 327977C61D9BBF1D00679858 /* AppDelegate.m in Sources */,
200   - 327977C31D9BBF1D00679858 /* main.m in Sources */,
201   - );
202   - runOnlyForDeploymentPostprocessing = 0;
203   - };
204   -/* End PBXSourcesBuildPhase section */
205   -
206   -/* Begin PBXVariantGroup section */
207   - 327977CA1D9BBF1D00679858 /* Main.storyboard */ = {
208   - isa = PBXVariantGroup;
209   - children = (
210   - 327977CB1D9BBF1D00679858 /* Base */,
211   - );
212   - name = Main.storyboard;
213   - sourceTree = "<group>";
214   - };
215   - 327977CF1D9BBF1D00679858 /* LaunchScreen.storyboard */ = {
216   - isa = PBXVariantGroup;
217   - children = (
218   - 327977D01D9BBF1D00679858 /* Base */,
219   - );
220   - name = LaunchScreen.storyboard;
221   - sourceTree = "<group>";
222   - };
223   -/* End PBXVariantGroup section */
224   -
225   -/* Begin XCBuildConfiguration section */
226   - 327977D31D9BBF1D00679858 /* Debug */ = {
227   - isa = XCBuildConfiguration;
228   - buildSettings = {
229   - ALWAYS_SEARCH_USER_PATHS = NO;
230   - CLANG_ANALYZER_NONNULL = YES;
231   - CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
232   - CLANG_CXX_LIBRARY = "libc++";
233   - CLANG_ENABLE_MODULES = YES;
234   - CLANG_ENABLE_OBJC_ARC = YES;
235   - CLANG_WARN_BOOL_CONVERSION = YES;
236   - CLANG_WARN_CONSTANT_CONVERSION = YES;
237   - CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
238   - CLANG_WARN_DOCUMENTATION_COMMENTS = YES;
239   - CLANG_WARN_EMPTY_BODY = YES;
240   - CLANG_WARN_ENUM_CONVERSION = YES;
241   - CLANG_WARN_INFINITE_RECURSION = YES;
242   - CLANG_WARN_INT_CONVERSION = YES;
243   - CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
244   - CLANG_WARN_SUSPICIOUS_MOVES = YES;
245   - CLANG_WARN_UNREACHABLE_CODE = YES;
246   - CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
247   - "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer";
248   - COPY_PHASE_STRIP = NO;
249   - DEBUG_INFORMATION_FORMAT = dwarf;
250   - ENABLE_STRICT_OBJC_MSGSEND = YES;
251   - ENABLE_TESTABILITY = YES;
252   - GCC_C_LANGUAGE_STANDARD = gnu99;
253   - GCC_DYNAMIC_NO_PIC = NO;
254   - GCC_NO_COMMON_BLOCKS = YES;
255   - GCC_OPTIMIZATION_LEVEL = 0;
256   - GCC_PREPROCESSOR_DEFINITIONS = (
257   - "DEBUG=1",
258   - "$(inherited)",
259   - );
260   - GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
261   - GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
262   - GCC_WARN_UNDECLARED_SELECTOR = YES;
263   - GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
264   - GCC_WARN_UNUSED_FUNCTION = YES;
265   - GCC_WARN_UNUSED_VARIABLE = YES;
266   - IPHONEOS_DEPLOYMENT_TARGET = 10.0;
267   - MTL_ENABLE_DEBUG_INFO = YES;
268   - ONLY_ACTIVE_ARCH = YES;
269   - SDKROOT = iphoneos;
270   - };
271   - name = Debug;
272   - };
273   - 327977D41D9BBF1D00679858 /* Release */ = {
274   - isa = XCBuildConfiguration;
275   - buildSettings = {
276   - ALWAYS_SEARCH_USER_PATHS = NO;
277   - CLANG_ANALYZER_NONNULL = YES;
278   - CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
279   - CLANG_CXX_LIBRARY = "libc++";
280   - CLANG_ENABLE_MODULES = YES;
281   - CLANG_ENABLE_OBJC_ARC = YES;
282   - CLANG_WARN_BOOL_CONVERSION = YES;
283   - CLANG_WARN_CONSTANT_CONVERSION = YES;
284   - CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
285   - CLANG_WARN_DOCUMENTATION_COMMENTS = YES;
286   - CLANG_WARN_EMPTY_BODY = YES;
287   - CLANG_WARN_ENUM_CONVERSION = YES;
288   - CLANG_WARN_INFINITE_RECURSION = YES;
289   - CLANG_WARN_INT_CONVERSION = YES;
290   - CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
291   - CLANG_WARN_SUSPICIOUS_MOVES = YES;
292   - CLANG_WARN_UNREACHABLE_CODE = YES;
293   - CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
294   - "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer";
295   - COPY_PHASE_STRIP = NO;
296   - DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
297   - ENABLE_NS_ASSERTIONS = NO;
298   - ENABLE_STRICT_OBJC_MSGSEND = YES;
299   - GCC_C_LANGUAGE_STANDARD = gnu99;
300   - GCC_NO_COMMON_BLOCKS = YES;
301   - GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
302   - GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
303   - GCC_WARN_UNDECLARED_SELECTOR = YES;
304   - GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
305   - GCC_WARN_UNUSED_FUNCTION = YES;
306   - GCC_WARN_UNUSED_VARIABLE = YES;
307   - IPHONEOS_DEPLOYMENT_TARGET = 10.0;
308   - MTL_ENABLE_DEBUG_INFO = NO;
309   - SDKROOT = iphoneos;
310   - VALIDATE_PRODUCT = YES;
311   - };
312   - name = Release;
313   - };
314   - 327977D61D9BBF1D00679858 /* Debug */ = {
315   - isa = XCBuildConfiguration;
316   - buildSettings = {
317   - ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
318   - DEVELOPMENT_TEAM = 94X49GG3ZW;
319   - ENABLE_BITCODE = NO;
320   - FRAMEWORK_SEARCH_PATHS = (
321   - "$(inherited)",
322   - "$(PROJECT_DIR)",
323   - );
324   - INFOPLIST_FILE = CNLiveXMPPManagerDemo/Info.plist;
325   - IPHONEOS_DEPLOYMENT_TARGET = 8.0;
326   - LD_RUNPATH_SEARCH_PATHS = "$(inherited) @executable_path/Frameworks";
327   - PRODUCT_BUNDLE_IDENTIFIER = com.cnlive.chat;
328   - PRODUCT_NAME = "$(TARGET_NAME)";
329   - };
330   - name = Debug;
331   - };
332   - 327977D71D9BBF1D00679858 /* Release */ = {
333   - isa = XCBuildConfiguration;
334   - buildSettings = {
335   - ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
336   - DEVELOPMENT_TEAM = 94X49GG3ZW;
337   - ENABLE_BITCODE = NO;
338   - FRAMEWORK_SEARCH_PATHS = (
339   - "$(inherited)",
340   - "$(PROJECT_DIR)",
341   - );
342   - INFOPLIST_FILE = CNLiveXMPPManagerDemo/Info.plist;
343   - IPHONEOS_DEPLOYMENT_TARGET = 8.0;
344   - LD_RUNPATH_SEARCH_PATHS = "$(inherited) @executable_path/Frameworks";
345   - PRODUCT_BUNDLE_IDENTIFIER = com.cnlive.chat;
346   - PRODUCT_NAME = "$(TARGET_NAME)";
347   - };
348   - name = Release;
349   - };
350   -/* End XCBuildConfiguration section */
351   -
352   -/* Begin XCConfigurationList section */
353   - 327977B91D9BBF1D00679858 /* Build configuration list for PBXProject "CNLiveXMPPManagerDemo" */ = {
354   - isa = XCConfigurationList;
355   - buildConfigurations = (
356   - 327977D31D9BBF1D00679858 /* Debug */,
357   - 327977D41D9BBF1D00679858 /* Release */,
358   - );
359   - defaultConfigurationIsVisible = 0;
360   - defaultConfigurationName = Release;
361   - };
362   - 327977D51D9BBF1D00679858 /* Build configuration list for PBXNativeTarget "CNLiveXMPPManagerDemo" */ = {
363   - isa = XCConfigurationList;
364   - buildConfigurations = (
365   - 327977D61D9BBF1D00679858 /* Debug */,
366   - 327977D71D9BBF1D00679858 /* Release */,
367   - );
368   - defaultConfigurationIsVisible = 0;
369   - defaultConfigurationName = Release;
370   - };
371   -/* End XCConfigurationList section */
372   - };
373   - rootObject = 327977B61D9BBF1D00679858 /* Project object */;
374   -}
CNLiveXMPPManagerDemo/CNLiveXMPPManagerDemo.xcodeproj/project.xcworkspace/contents.xcworkspacedata deleted 100644 → 0
  View file @b6c7dfc
1   -<?xml version="1.0" encoding="UTF-8"?>
2   -<Workspace
3   - version = "1.0">
4   - <FileRef
5   - location = "self:CNLiveXMPPManagerDemo.xcodeproj">
6   - </FileRef>
7   -</Workspace>
CNLiveXMPPManagerDemo/CNLiveXMPPManagerDemo.xcodeproj/xcuserdata/leihaojie.xcuserdatad/xcschemes/CNLiveXMPPManagerDemo.xcscheme deleted 100644 → 0
  View file @b6c7dfc
1   -<?xml version="1.0" encoding="UTF-8"?>
2   -<Scheme
3   - LastUpgradeVersion = "0800"
4   - version = "1.3">
5   - <BuildAction
6   - parallelizeBuildables = "YES"
7   - buildImplicitDependencies = "YES">
8   - <BuildActionEntries>
9   - <BuildActionEntry
10   - buildForTesting = "YES"
11   - buildForRunning = "YES"
12   - buildForProfiling = "YES"
13   - buildForArchiving = "YES"
14   - buildForAnalyzing = "YES">
15   - <BuildableReference
16   - BuildableIdentifier = "primary"
17   - BlueprintIdentifier = "327977BD1D9BBF1D00679858"
18   - BuildableName = "CNLiveXMPPManagerDemo.app"
19   - BlueprintName = "CNLiveXMPPManagerDemo"
20   - ReferencedContainer = "container:CNLiveXMPPManagerDemo.xcodeproj">
21   - </BuildableReference>
22   - </BuildActionEntry>
23   - </BuildActionEntries>
24   - </BuildAction>
25   - <TestAction
26   - buildConfiguration = "Debug"
27   - selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
28   - selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
29   - shouldUseLaunchSchemeArgsEnv = "YES">
30   - <Testables>
31   - </Testables>
32   - <MacroExpansion>
33   - <BuildableReference
34   - BuildableIdentifier = "primary"
35   - BlueprintIdentifier = "327977BD1D9BBF1D00679858"
36   - BuildableName = "CNLiveXMPPManagerDemo.app"
37   - BlueprintName = "CNLiveXMPPManagerDemo"
38   - ReferencedContainer = "container:CNLiveXMPPManagerDemo.xcodeproj">
39   - </BuildableReference>
40   - </MacroExpansion>
41   - <AdditionalOptions>
42   - </AdditionalOptions>
43   - </TestAction>
44   - <LaunchAction
45   - buildConfiguration = "Debug"
46   - selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
47   - selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
48   - launchStyle = "0"
49   - useCustomWorkingDirectory = "NO"
50   - ignoresPersistentStateOnLaunch = "NO"
51   - debugDocumentVersioning = "YES"
52   - debugServiceExtension = "internal"
53   - allowLocationSimulation = "YES">
54   - <BuildableProductRunnable
55   - runnableDebuggingMode = "0">
56   - <BuildableReference
57   - BuildableIdentifier = "primary"
58   - BlueprintIdentifier = "327977BD1D9BBF1D00679858"
59   - BuildableName = "CNLiveXMPPManagerDemo.app"
60   - BlueprintName = "CNLiveXMPPManagerDemo"
61   - ReferencedContainer = "container:CNLiveXMPPManagerDemo.xcodeproj">
62   - </BuildableReference>
63   - </BuildableProductRunnable>
64   - <AdditionalOptions>
65   - </AdditionalOptions>
66   - </LaunchAction>
67   - <ProfileAction
68   - buildConfiguration = "Release"
69   - shouldUseLaunchSchemeArgsEnv = "YES"
70   - savedToolIdentifier = ""
71   - useCustomWorkingDirectory = "NO"
72   - debugDocumentVersioning = "YES">
73   - <BuildableProductRunnable
74   - runnableDebuggingMode = "0">
75   - <BuildableReference
76   - BuildableIdentifier = "primary"
77   - BlueprintIdentifier = "327977BD1D9BBF1D00679858"
78   - BuildableName = "CNLiveXMPPManagerDemo.app"
79   - BlueprintName = "CNLiveXMPPManagerDemo"
80   - ReferencedContainer = "container:CNLiveXMPPManagerDemo.xcodeproj">
81   - </BuildableReference>
82   - </BuildableProductRunnable>
83   - </ProfileAction>
84   - <AnalyzeAction
85   - buildConfiguration = "Debug">
86   - </AnalyzeAction>
87   - <ArchiveAction
88   - buildConfiguration = "Release"
89   - revealArchiveInOrganizer = "YES">
90   - </ArchiveAction>
91   -</Scheme>
CNLiveXMPPManagerDemo/CNLiveXMPPManagerDemo.xcodeproj/xcuserdata/leihaojie.xcuserdatad/xcschemes/xcschememanagement.plist deleted 100644 → 0
  View file @b6c7dfc
1   -<?xml version="1.0" encoding="UTF-8"?>
2   -<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
3   -<plist version="1.0">
4   -<dict>
5   - <key>SchemeUserState</key>
6   - <dict>
7   - <key>CNLiveXMPPManagerDemo.xcscheme</key>
8   - <dict>
9   - <key>orderHint</key>
10   - <integer>0</integer>
11   - </dict>
12   - </dict>
13   - <key>SuppressBuildableAutocreation</key>
14   - <dict>
15   - <key>327977BD1D9BBF1D00679858</key>
16   - <dict>
17   - <key>primary</key>
18   - <true/>
19   - </dict>
20   - </dict>
21   -</dict>
22   -</plist>
CNLiveXMPPManagerDemo/CNLiveXMPPManagerDemo/AppDelegate.h deleted 100644 → 0
  View file @b6c7dfc
1   -//
2   -// AppDelegate.h
3   -// CNLiveXMPPManagerDemo
4   -//
5   -// Created by 雷浩杰 on 16/9/28.
6   -// Copyright © 2016年 雷浩杰. All rights reserved.
7   -//
8   -
9   -#import <UIKit/UIKit.h>
10   -
11   -@interface AppDelegate : UIResponder <UIApplicationDelegate>
12   -
13   -@property (strong, nonatomic) UIWindow *window;
14   -
15   -
16   -@end
17   -
CNLiveXMPPManagerDemo/CNLiveXMPPManagerDemo/AppDelegate.m deleted 100644 → 0
  View file @b6c7dfc
1   -//
2   -// AppDelegate.m
3   -// CNLiveXMPPManagerDemo
4   -//
5   -// Created by 雷浩杰 on 16/9/28.
6   -// Copyright © 2016年 雷浩杰. All rights reserved.
7   -//
8   -
9   -#import "AppDelegate.h"
10   -
11   -@interface AppDelegate ()
12   -
13   -@end
14   -
15   -@implementation AppDelegate
16   -
17   -
18   -- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
19   - // Override point for customization after application launch.
20   - return YES;
21   -}
22   -
23   -
24   -- (void)applicationWillResignActive:(UIApplication *)application {
25   - // Sent when the application is about to move from active to inactive state. This can occur for certain types of temporary interruptions (such as an incoming phone call or SMS message) or when the user quits the application and it begins the transition to the background state.
26   - // Use this method to pause ongoing tasks, disable timers, and invalidate graphics rendering callbacks. Games should use this method to pause the game.
27   -}
28   -
29   -
30   -- (void)applicationDidEnterBackground:(UIApplication *)application {
31   - // Use this method to release shared resources, save user data, invalidate timers, and store enough application state information to restore your application to its current state in case it is terminated later.
32   - // If your application supports background execution, this method is called instead of applicationWillTerminate: when the user quits.
33   -}
34   -
35   -
36   -- (void)applicationWillEnterForeground:(UIApplication *)application {
37   - // Called as part of the transition from the background to the active state; here you can undo many of the changes made on entering the background.
38   -}
39   -
40   -
41   -- (void)applicationDidBecomeActive:(UIApplication *)application {
42   - // Restart any tasks that were paused (or not yet started) while the application was inactive. If the application was previously in the background, optionally refresh the user interface.
43   -}
44   -
45   -
46   -- (void)applicationWillTerminate:(UIApplication *)application {
47   - // Called when the application is about to terminate. Save data if appropriate. See also applicationDidEnterBackground:.
48   -}
49   -
50   -
51   -@end
CNLiveXMPPManagerDemo/CNLiveXMPPManagerDemo/Assets.xcassets/AppIcon.appiconset/Contents.json deleted 100644 → 0
  View file @b6c7dfc
1   -{
2   - "images" : [
3   - {
4   - "idiom" : "iphone",
5   - "size" : "20x20",
6   - "scale" : "2x"
7   - },
8   - {
9   - "idiom" : "iphone",
10   - "size" : "20x20",
11   - "scale" : "3x"
12   - },
13   - {
14   - "idiom" : "iphone",
15   - "size" : "29x29",
16   - "scale" : "2x"
17   - },
18   - {
19   - "idiom" : "iphone",
20   - "size" : "29x29",
21   - "scale" : "3x"
22   - },
23   - {
24   - "idiom" : "iphone",
25   - "size" : "40x40",
26   - "scale" : "2x"
27   - },
28   - {
29   - "idiom" : "iphone",
30   - "size" : "40x40",
31   - "scale" : "3x"
32   - },
33   - {
34   - "idiom" : "iphone",
35   - "size" : "60x60",
36   - "scale" : "2x"
37   - },
38   - {
39   - "idiom" : "iphone",
40   - "size" : "60x60",
41   - "scale" : "3x"
42   - }
43   - ],
44   - "info" : {
45   - "version" : 1,
46   - "author" : "xcode"
47   - }
48   -}
49 0 \ No newline at end of file
CNLiveXMPPManagerDemo/CNLiveXMPPManagerDemo/Base.lproj/LaunchScreen.storyboard deleted 100644 → 0
  View file @b6c7dfc
1   -<?xml version="1.0" encoding="UTF-8" standalone="no"?>
2   -<document type="com.apple.InterfaceBuilder3.CocoaTouch.Storyboard.XIB" version="3.0" toolsVersion="11134" systemVersion="15F34" targetRuntime="iOS.CocoaTouch" propertyAccessControl="none" useAutolayout="YES" launchScreen="YES" useTraitCollections="YES" colorMatched="YES" initialViewController="01J-lp-oVM">
3   - <dependencies>
4   - <plugIn identifier="com.apple.InterfaceBuilder.IBCocoaTouchPlugin" version="11106"/>
5   - <capability name="documents saved in the Xcode 8 format" minToolsVersion="8.0"/>
6   - </dependencies>
7   - <scenes>
8   - <!--View Controller-->
9   - <scene sceneID="EHf-IW-A2E">
10   - <objects>
11   - <viewController id="01J-lp-oVM" sceneMemberID="viewController">
12   - <layoutGuides>
13   - <viewControllerLayoutGuide type="top" id="Llm-lL-Icb"/>
14   - <viewControllerLayoutGuide type="bottom" id="xb3-aO-Qok"/>
15   - </layoutGuides>
16   - <view key="view" contentMode="scaleToFill" id="Ze5-6b-2t3">
17   - <rect key="frame" x="0.0" y="0.0" width="375" height="667"/>
18   - <autoresizingMask key="autoresizingMask" widthSizable="YES" heightSizable="YES"/>
19   - <color key="backgroundColor" red="1" green="1" blue="1" alpha="1" colorSpace="custom" customColorSpace="sRGB"/>
20   - </view>
21   - </viewController>
22   - <placeholder placeholderIdentifier="IBFirstResponder" id="iYj-Kq-Ea1" userLabel="First Responder" sceneMemberID="firstResponder"/>
23   - </objects>
24   - <point key="canvasLocation" x="53" y="375"/>
25   - </scene>
26   - </scenes>
27   -</document>
CNLiveXMPPManagerDemo/CNLiveXMPPManagerDemo/Base.lproj/Main.storyboard deleted 100644 → 0
  View file @b6c7dfc
1   -<?xml version="1.0" encoding="UTF-8"?>
2   -<document type="com.apple.InterfaceBuilder3.CocoaTouch.Storyboard.XIB" version="3.0" toolsVersion="11762" systemVersion="16D32" targetRuntime="iOS.CocoaTouch" propertyAccessControl="none" useAutolayout="YES" useTraitCollections="YES" colorMatched="YES" initialViewController="06n-aH-okM">
3   - <device id="retina4_7" orientation="portrait">
4   - <adaptation id="fullscreen"/>
5   - </device>
6   - <dependencies>
7   - <deployment identifier="iOS"/>
8   - <plugIn identifier="com.apple.InterfaceBuilder.IBCocoaTouchPlugin" version="11757"/>
9   - <capability name="documents saved in the Xcode 8 format" minToolsVersion="8.0"/>
10   - </dependencies>
11   - <scenes>
12   - <!--互动云 聊天室SDK Demo-->
13   - <scene sceneID="tne-QT-ifu">
14   - <objects>
15   - <viewController id="BYZ-38-t0r" customClass="ViewController" sceneMemberID="viewController">
16   - <layoutGuides>
17   - <viewControllerLayoutGuide type="top" id="y3c-jy-aDJ"/>
18   - <viewControllerLayoutGuide type="bottom" id="wfy-db-euE"/>
19   - </layoutGuides>
20   - <view key="view" contentMode="scaleToFill" id="8bC-Xf-vdC">
21   - <rect key="frame" x="0.0" y="0.0" width="375" height="667"/>
22   - <autoresizingMask key="autoresizingMask" widthSizable="YES" heightSizable="YES"/>
23   - <color key="backgroundColor" red="1" green="1" blue="1" alpha="1" colorSpace="custom" customColorSpace="sRGB"/>
24   - </view>
25   - <navigationItem key="navigationItem" title="互动云 聊天室SDK Demo" id="BWk-fb-LQT"/>
26   - </viewController>
27   - <placeholder placeholderIdentifier="IBFirstResponder" id="dkx-z0-nzr" sceneMemberID="firstResponder"/>
28   - </objects>
29   - <point key="canvasLocation" x="964" y="36.431784107946029"/>
30   - </scene>
31   - <!--Navigation Controller-->
32   - <scene sceneID="AHB-iF-bKU">
33   - <objects>
34   - <navigationController automaticallyAdjustsScrollViewInsets="NO" id="06n-aH-okM" sceneMemberID="viewController">
35   - <toolbarItems/>
36   - <navigationBar key="navigationBar" contentMode="scaleToFill" id="ZOL-0v-2oc">
37   - <rect key="frame" x="0.0" y="0.0" width="375" height="44"/>
38   - <autoresizingMask key="autoresizingMask"/>
39   - </navigationBar>
40   - <nil name="viewControllers"/>
41   - <connections>
42   - <segue destination="BYZ-38-t0r" kind="relationship" relationship="rootViewController" id="fMx-a7-zk6"/>
43   - </connections>
44   - </navigationController>
45   - <placeholder placeholderIdentifier="IBFirstResponder" id="AKz-aK-FZ7" userLabel="First Responder" sceneMemberID="firstResponder"/>
46   - </objects>
47   - <point key="canvasLocation" x="116" y="-646.32683658170924"/>
48   - </scene>
49   - </scenes>
50   -</document>
CNLiveXMPPManagerDemo/CNLiveXMPPManagerDemo/Info.plist deleted 100644 → 0
  View file @b6c7dfc
1   -<?xml version="1.0" encoding="UTF-8"?>
2   -<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
3   -<plist version="1.0">
4   -<dict>
5   - <key>CFBundleDevelopmentRegion</key>
6   - <string>en</string>
7   - <key>CFBundleExecutable</key>
8   - <string>$(EXECUTABLE_NAME)</string>
9   - <key>CFBundleIdentifier</key>
10   - <string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
11   - <key>CFBundleInfoDictionaryVersion</key>
12   - <string>6.0</string>
13   - <key>CFBundleName</key>
14   - <string>$(PRODUCT_NAME)</string>
15   - <key>CFBundlePackageType</key>
16   - <string>APPL</string>
17   - <key>CFBundleShortVersionString</key>
18   - <string>1.0</string>
19   - <key>CFBundleVersion</key>
20   - <string>1</string>
21   - <key>LSRequiresIPhoneOS</key>
22   - <true/>
23   - <key>NSAppTransportSecurity</key>
24   - <dict>
25   - <key>NSAllowsArbitraryLoads</key>
26   - <true/>
27   - </dict>
28   - <key>UILaunchStoryboardName</key>
29   - <string>LaunchScreen</string>
30   - <key>UIMainStoryboardFile</key>
31   - <string>Main</string>
32   - <key>UIRequiredDeviceCapabilities</key>
33   - <array>
34   - <string>armv7</string>
35   - </array>
36   - <key>UISupportedInterfaceOrientations</key>
37   - <array>
38   - <string>UIInterfaceOrientationPortrait</string>
39   - <string>UIInterfaceOrientationLandscapeLeft</string>
40   - <string>UIInterfaceOrientationLandscapeRight</string>
41   - </array>
42   -</dict>
43   -</plist>
CNLiveXMPPManagerDemo/CNLiveXMPPManagerDemo/ViewController.h deleted 100644 → 0
  View file @b6c7dfc
1   -//
2   -// ViewController.h
3   -// CNLiveXMPPManagerDemo
4   -//
5   -// Created by 雷浩杰 on 16/9/28.
6   -// Copyright © 2016年 雷浩杰. All rights reserved.
7   -//
8   -
9   -#import <UIKit/UIKit.h>
10   -
11   -@interface ViewController : UIViewController
12   -
13   -
14   -@end
15   -
CNLiveXMPPManagerDemo/CNLiveXMPPManagerDemo/ViewController.m deleted 100644 → 0
  View file @b6c7dfc
1   -//
2   -// ViewController.m
3   -// CNLiveXMPPManagerDemo
4   -//
5   -// Created by 雷浩杰 on 16/9/28.
6   -// Copyright © 2016年 雷浩杰. All rights reserved.
7   -//
8   -
9   -#import "ViewController.h"
10   -
11   -#import <CNLiveXMPPSDK/CNLiveXMPPManager.h>
12   -
13   -#define ScreenWidth ([UIScreen mainScreen].bounds.size.width)
14   -#define ScreenHeight ([UIScreen mainScreen].bounds.size.height)
15   -#define ButtonWidth (ScreenWidth / 4)
16   -
17   -#define KAppId @"60_irn9cdak77"
18   -#define KAppKey @"a425987ebc86e352b3373c25d5bd082d0cc248b4043028"
19   -#define KRoomId @"60_cnlivetest"
20   -
21   -@interface ViewController ()<XMPPManagerDelegate>
22   -
23   -@property (nonatomic, strong) CNLiveXMPPManager *manager;
24   -@property (nonatomic, strong) UIButton *button;
25   -@property (nonatomic, strong) UIButton *leaveRoomBtn;
26   -@property (nonatomic, strong) UIButton *disconnectXmppBtn;
27   -@property (nonatomic, strong) UIButton *reconnectBtn;
28   -@property (nonatomic, strong) UIButton *rejoinChatroomBtn;
29   -@property (nonatomic, strong) UIButton *changeNickBtn;
30   -@property (nonatomic, strong) UITextField *textField;
31   -@property (nonatomic, strong) UITextView *textView;
32   -@property (nonatomic, strong) NSMutableString *mutableStr;
33   -@property (nonatomic, copy) NSString *nickStr;
34   -
35   -@end
36   -
37   -@implementation ViewController
38   -
39   -- (void)viewDidLoad {
40   - [super viewDidLoad];
41   -
42   - // Do any additional setup after loading the view, typically from a nib.
43   - [self.view addSubview:self.button];
44   - [self.view addSubview:self.leaveRoomBtn];
45   - [self.view addSubview:self.disconnectXmppBtn];
46   - [self.view addSubview:self.reconnectBtn];
47   - [self.view addSubview:self.rejoinChatroomBtn];
48   - [self.view addSubview:self.changeNickBtn];
49   - [self.view addSubview:self.textField];
50   - [self.view addSubview:self.textView];
51   - self.nickStr = @"CNLiveChatTest1";
52   - [self.manager joinRoomWithNickName:self.nickStr];
53   -
54   - UITapGestureRecognizer *tap = [[UITapGestureRecognizer alloc] initWithTarget:self action:@selector(textFieldResignFirstResponder)];
55   - [self.view addGestureRecognizer:tap];
56   -
57   - UILabel *label = [[UILabel alloc] initWithFrame:CGRectMake(0, CGRectGetHeight([UIScreen mainScreen].bounds)-40, CGRectGetWidth(self.view.frame), 30)];
58   - label.text = @"北京中投视讯文化传媒股份有限公司";
59   - [self.view addSubview:label];
60   - label.font = [UIFont systemFontOfSize:12];
61   - label.textAlignment = NSTextAlignmentCenter;
62   -}
63   -
64   -- (UITextField *)textField
65   -{
66   - if (!_textField) {
67   - _textField = [[UITextField alloc] initWithFrame:CGRectMake(0, 154, ScreenWidth, 40)];
68   - _textField.borderStyle = UITextBorderStyleLine;
69   - }
70   - return _textField;
71   -}
72   -
73   -- (UIButton *)button
74   -{
75   - if (!_button) {
76   - _button = [UIButton buttonWithType:UIButtonTypeCustom];
77   - [_button setFrame:CGRectMake(40, 204, 100, 30)];
78   - [_button setTitleColor:[UIColor colorWithRed:23/255.0 green:110/255.0 blue:254/255.0 alpha:1] forState:UIControlStateNormal];
79   - [_button setTitle:@"发送" forState:UIControlStateNormal];
80   - _button.tag = 10001;
81   - [_button addTarget:self action:@selector(buttonAction:) forControlEvents:UIControlEventTouchUpInside];
82   - [self setButtonBorder:_button];
83   - }
84   - return _button;
85   -}
86   -
87   -- (UIButton *)changeNickBtn
88   -{
89   - if (!_changeNickBtn) {
90   - _changeNickBtn = [UIButton buttonWithType:UIButtonTypeCustom];
91   - [_changeNickBtn setFrame:CGRectMake(ScreenWidth-140, 204, 100, 30)];
92   - [_changeNickBtn setTitle:@"更改昵称" forState:UIControlStateNormal];
93   - [_changeNickBtn setTitleColor:[UIColor colorWithRed:23/255.0 green:110/255.0 blue:254/255.0 alpha:1] forState:UIControlStateNormal];
94   - _changeNickBtn.tag = 10002;
95   - [_changeNickBtn addTarget:self action:@selector(buttonAction:) forControlEvents:UIControlEventTouchUpInside];
96   - [self setButtonBorder:_changeNickBtn];
97   - }
98   - return _changeNickBtn;
99   -}
100   -
101   -- (UIButton *)leaveRoomBtn
102   -{
103   - if (!_leaveRoomBtn) {
104   - _leaveRoomBtn = [UIButton buttonWithType:UIButtonTypeCustom];
105   - [_leaveRoomBtn setFrame:CGRectMake(ScreenWidth-150, 74, 120, 30)];
106   - [_leaveRoomBtn setTitle:@"离开聊天室" forState:UIControlStateNormal];
107   - [_leaveRoomBtn setTitleColor:[UIColor colorWithRed:23/255.0 green:110/255.0 blue:254/255.0 alpha:1] forState:UIControlStateNormal];
108   - [_leaveRoomBtn.titleLabel setAdjustsFontSizeToFitWidth:YES];
109   - _leaveRoomBtn.tag = 10003;
110   - [_leaveRoomBtn addTarget:self action:@selector(buttonAction:) forControlEvents:UIControlEventTouchUpInside];
111   - [self setButtonBorder:_leaveRoomBtn];
112   - }
113   - return _leaveRoomBtn;
114   -}
115   -
116   -- (UIButton *)disconnectXmppBtn
117   -{
118   - if (!_disconnectXmppBtn) {
119   - _disconnectXmppBtn = [UIButton buttonWithType:UIButtonTypeCustom];
120   - [_disconnectXmppBtn setFrame:CGRectMake(30, 74, 120, 30)];
121   - [_disconnectXmppBtn setTitle:@"断开XMPP" forState:UIControlStateNormal];
122   - [_disconnectXmppBtn setTitleColor:[UIColor colorWithRed:23/255.0 green:110/255.0 blue:254/255.0 alpha:1] forState:UIControlStateNormal];
123   - [_disconnectXmppBtn.titleLabel setAdjustsFontSizeToFitWidth:YES];
124   - _disconnectXmppBtn.tag = 10004;
125   - [_disconnectXmppBtn addTarget:self action:@selector(buttonAction:) forControlEvents:UIControlEventTouchUpInside];
126   - [self setButtonBorder:_disconnectXmppBtn];
127   - }
128   - return _disconnectXmppBtn;
129   -}
130   -
131   -- (UIButton *)reconnectBtn
132   -{
133   - if (!_reconnectBtn) {
134   - _reconnectBtn = [UIButton buttonWithType:UIButtonTypeCustom];
135   - [_reconnectBtn setFrame:CGRectMake(30, 114, 120, 30)];
136   - [_reconnectBtn setTitle:@"重连XMPP" forState:UIControlStateNormal];
137   - [_reconnectBtn setTitleColor:[UIColor colorWithRed:23/255.0 green:110/255.0 blue:254/255.0 alpha:1] forState:UIControlStateNormal];
138   - [_reconnectBtn.titleLabel setAdjustsFontSizeToFitWidth:YES];
139   - _reconnectBtn.tag = 10005;
140   - [_reconnectBtn addTarget:self action:@selector(buttonAction:) forControlEvents:UIControlEventTouchUpInside];
141   - [self setButtonBorder:_reconnectBtn];
142   - }
143   - return _reconnectBtn;
144   -}
145   -
146   -- (UIButton *)rejoinChatroomBtn
147   -{
148   - if (!_rejoinChatroomBtn) {
149   - _rejoinChatroomBtn = [UIButton buttonWithType:UIButtonTypeCustom];
150   - [_rejoinChatroomBtn setFrame:CGRectMake(ScreenWidth-150, 114, 120, 30)];
151   - [_rejoinChatroomBtn setTitle:@"重连聊天室" forState:UIControlStateNormal];
152   - [_rejoinChatroomBtn setTitleColor:[UIColor colorWithRed:23/255.0 green:110/255.0 blue:254/255.0 alpha:1] forState:UIControlStateNormal];
153   - [_rejoinChatroomBtn.titleLabel setAdjustsFontSizeToFitWidth:YES];
154   - _rejoinChatroomBtn.tag = 10006;
155   - [_rejoinChatroomBtn addTarget:self action:@selector(buttonAction:) forControlEvents:UIControlEventTouchUpInside];
156   - [self setButtonBorder:_rejoinChatroomBtn];
157   - }
158   - return _rejoinChatroomBtn;
159   -}
160   -
161   -- (void)setButtonBorder:(UIButton *)button
162   -{
163   - button.layer.borderWidth = 1;
164   - button.layer.borderColor = [UIColor blackColor].CGColor;
165   - button.layer.cornerRadius = 15;
166   - button.layer.masksToBounds = YES;
167   -}
168   -
169   -- (UITextView *)textView
170   -{
171   - if (!_textView) {
172   - _textView = [[UITextView alloc] initWithFrame:CGRectMake(0, 244, ScreenWidth, ScreenHeight-294)];
173   - _textView.editable = NO;
174   - _textView.layer.borderWidth = 1;
175   - _textView.layer.borderColor = [UIColor blackColor].CGColor;
176   - }
177   - return _textView;
178   -}
179   -
180   -- (NSMutableString *)mutableStr
181   -{
182   - if (!_mutableStr) {
183   - _mutableStr = [NSMutableString stringWithCapacity:0];
184   - }
185   - return _mutableStr;
186   -}
187   -
188   -- (void)textFieldResignFirstResponder
189   -{
190   - [self.textField resignFirstResponder];
191   -}
192   -
193   -- (void)buttonAction:(UIButton *)button
194   -{
195   - switch (button.tag) {
196   - case 10001:
197   - {
198   - NSDictionary *dic = @{@"name":self.nickStr,@"content":self.textField.text};
199   - [self.manager sendMessage:[self dictionaryToJson:dic]];
200   - self.textField.text = @"";
201   - [self.textField resignFirstResponder];
202   - }
203   - break;
204   - case 10002:
205   - {
206   - self.nickStr = self.textField.text;
207   - [self.manager changeNickname:self.textField.text];
208   - self.textField.text = @"";
209   - [self.textField resignFirstResponder];
210   - }
211   - break;
212   - case 10003:
213   - {
214   - [self.manager leaveRoom];
215   - }
216   - break;
217   - case 10004:
218   - {
219   - [self.manager disconnect];
220   - }
221   - break;
222   - case 10005:
223   - {
224   - [self.manager reconnection];
225   - }
226   - break;
227   - case 10006:
228   - {
229   - [self.manager joinRoomWithNickName:self.nickStr];
230   - }
231   - break;
232   - default:
233   - break;
234   - }
235   -}
236   -- (NSString *)dictionaryToJson:(NSDictionary *)dic
237   -{
238   - NSError *parseError = nil;
239   - NSData *jsonData = [NSJSONSerialization dataWithJSONObject:dic options:NSJSONWritingPrettyPrinted error:&parseError];
240   - return [[NSString alloc] initWithData:jsonData encoding:NSUTF8StringEncoding];
241   -}
242   -- (CNLiveXMPPManager *)manager
243   -{
244   - if (!_manager) {
245   - _manager = [[CNLiveXMPPManager alloc] initWithChatRoomId:KRoomId appId:KAppId app_key:KAppKey autoReconnect:NO];
246   - _manager.receiveHistory = YES;
247   - _manager.delegate = self;
248   - }
249   - return _manager;
250   -}
251   -
252   -- (void)connectXmppSuccess
253   -{
254   - NSLog(@"connectXmppSuccess");
255   - [self reloadMessage:@"connectXmppSuccess"];
256   -
257   -}
258   -
259   -- (void)xmppDidDisconnect:(NSError *)error
260   -{
261   - NSLog(@"xmppDidDisconnect:%@",error.localizedDescription);
262   - [self reloadMessage:[NSString stringWithFormat:@"xmppDidDisconnect:%@",error.localizedDescription]];
263   - // [self.manager reconnection];
264   -}
265   -
266   -- (void)connectChatRoomFailed:(NSError *)error
267   -{
268   - NSLog(@"connectChatRoomFailed:%@",error);
269   - [self reloadMessage:[NSString stringWithFormat:@"connectChatRoomFailed:%@",error]];
270   -}
271   -
272   -- (void)getAccessPermissionsFailed:(NSError *)error
273   -{
274   - NSLog(@"getAccessPermissionsFailed:%@",error);
275   - [self reloadMessage:[NSString stringWithFormat:@"getAccessPermissionsFailed:%@",error]];
276   -}
277   -- (void)didJoinRoom:(NSString *)roomName
278   -{
279   - NSLog(@"didJoinRoom:%@",roomName);
280   - [self reloadMessage:[NSString stringWithFormat:@"didJoinRoom:%@",roomName]];
281   -}
282   -- (void)didLeaveRoom:(NSString *)roomName
283   -{
284   - NSLog(@"didLeaveRoom:%@",roomName);
285   - [self reloadMessage:[NSString stringWithFormat:@"didLeaveRoom:%@",roomName]];
286   -}
287   -
288   -- (void)receivedMessage:(NSString *)msg fromUser:(NSString *)userName
289   -{
290   - NSLog(@"userName = %@, msg = %@",userName,msg);
291   - [self reloadMessage:[NSString stringWithFormat:@"userName = %@\nmsg = \n%@",userName,msg]];
292   -}
293   -
294   -- (void)sendMessageFailed:(NSError *)error
295   -{
296   - NSLog(@"sendMessageFailed:%@",error);
297   - [self reloadMessage:[NSString stringWithFormat:@"sendMessageFailed:%@",error]];
298   -}
299   -
300   -- (void)nicknameConflict:(NSString *)nickname
301   -{
302   - NSLog(@"nicknameConflict:%@",nickname);
303   - self.nickStr = nickname;
304   - [self reloadMessage:[NSString stringWithFormat:@"nicknameConflict:%@",nickname]];
305   -}
306   -
307   -- (void)reloadMessage:(NSString *)msg
308   -{
309   - [self.mutableStr appendString:[NSString stringWithFormat:@"%@\n",msg]];
310   - self.textView.text = self.mutableStr;
311   - [self.textView scrollRangeToVisible:NSMakeRange(self.textView.text.length, 1)];
312   -
313   -// [self.textView sc]
314   -}
315   -
316   -
317   -- (void)didReceiveMemoryWarning {
318   - [super didReceiveMemoryWarning];
319   - // Dispose of any resources that can be recreated.
320   -}
321   -
322   -
323   -@end
CNLiveXMPPManagerDemo/CNLiveXMPPManagerDemo/main.m deleted 100644 → 0
  View file @b6c7dfc
1   -//
2   -// main.m
3   -// CNLiveXMPPManagerDemo
4   -//
5   -// Created by 雷浩杰 on 16/9/28.
6   -// Copyright © 2016年 雷浩杰. All rights reserved.
7   -//
8   -
9   -#import <UIKit/UIKit.h>
10   -#import "AppDelegate.h"
11   -
12   -int main(int argc, char * argv[]) {
13   - @autoreleasepool {
14   - return UIApplicationMain(argc, argv, nil, NSStringFromClass([AppDelegate class]));
15   - }
16   -}
CNLiveXMPPManagerDemo/CNLiveXMPPSDK.framework/CNLiveXMPPSDK deleted 100755 → 0
View file @b6c7dfc
No preview for this file type
CNLiveXMPPManagerDemo/CNLiveXMPPSDK.framework/Headers/CNLiveXMPPManager.h deleted 100644 → 0
  View file @b6c7dfc
1   -//
2   -// XMPPManager.h
3   -// XMPP
4   -//
5   -// Created by CNLive on 13-5-16.
6   -// Copyright (c) 2013年 CNLive. All rights reserved.
7   -//
8   -
9   -#import <Foundation/Foundation.h>
10   -
11   -@protocol XMPPManagerDelegate <NSObject>
12   -
13   -@optional
14   -
15   -- (void)getAccessPermissionsFailed:(NSError *)error; // 鉴权失败回调
16   -
17   -- (void)connectChatRoomFailed:(NSError *)error; // 加入聊天室失败
18   -
19   -- (void)connectXmppSuccess; // 连接xmpp成功
20   -
21   -- (void)xmppDidDisconnect:(NSError *)error; // xmpp主动或者被动断开连接
22   -
23   -- (void)didJoinRoom:(NSString *)roomName; // 已经加入聊天室
24   -
25   -- (void)didLeaveRoom:(NSString *)roomName; // 已经离开聊天室
26   -
27   -- (void)receivedMessage:(NSString *)msg fromUser:(NSString *)userName; // 从聊天室收到的消息
28   -
29   -- (void)sendMessageFailed:(NSError *)error; // 发送消息失败
30   -
31   -- (void)nicknameConflict:(NSString *)nickname; // 昵称冲突
32   -
33   -@end
34   -
35   -@interface CNLiveXMPPManager : NSObject
36   -
37   -/*
38   - * 获取SDK版本号
39   - */
40   -+ (NSString *)getVersion;
41   -
42   -// 是否接收历史消息
43   -@property (nonatomic, assign) BOOL receiveHistory;
44   -
45   -// 代理
46   -@property (nonatomic, weak) id<XMPPManagerDelegate> delegate;
47   -
48   -// 初始化方法
49   -/*
50   - 如果autoReconnect为YES，- (void)reconnection 方法失效，XMPP会自动断线重连
51   - */
52   -- (instancetype)initWithChatRoomId:(NSString *)roomId appId:(NSString *)appId app_key:(NSString *)appKey autoReconnect:(BOOL)reconnect;
53   -
54   -// 使用某一昵称加入聊天室
55   -- (void)joinRoomWithNickName:(NSString *)nick;
56   -
57   -// 发送消息
58   -- (void)sendMessage:(NSString *)message;
59   -
60   -// 更换昵称
61   -- (void)changeNickname:(NSString*)nickname;
62   -
63   -// 重新连接xmpp
64   -- (void)reconnection;
65   -
66   -// 离开聊天室
67   -- (void)leaveRoom;
68   -
69   -// 断开xmpp链接
70   -- (void)disconnect;
71   -@end
CNLiveXMPPManagerDemo/CNLiveXMPPSDK.framework/Info.plist deleted 100644 → 0
View file @b6c7dfc
No preview for this file type
CNLiveXMPPManagerDemo/CocoaAsyncSocket.framework/CocoaAsyncSocket deleted 100755 → 0
View file @b6c7dfc
No preview for this file type
CNLiveXMPPManagerDemo/CocoaAsyncSocket.framework/Headers/CocoaAsyncSocket-umbrella.h deleted 100644 → 0
  View file @b6c7dfc
1   -#import <UIKit/UIKit.h>
2   -
3   -#import "GCDAsyncSocket.h"
4   -#import "GCDAsyncUdpSocket.h"
5   -
6   -FOUNDATION_EXPORT double CocoaAsyncSocketVersionNumber;
7   -FOUNDATION_EXPORT const unsigned char CocoaAsyncSocketVersionString[];
8   -
CNLiveXMPPManagerDemo/CocoaAsyncSocket.framework/Headers/GCDAsyncSocket.h deleted 100644 → 0
  View file @b6c7dfc
1   -//
2   -// GCDAsyncSocket.h
3   -//
4   -// This class is in the public domain.
5   -// Originally created by Robbie Hanson in Q3 2010.
6   -// Updated and maintained by Deusty LLC and the Apple development community.
7   -//
8   -// https://github.com/robbiehanson/CocoaAsyncSocket
9   -//
10   -
11   -#import <Foundation/Foundation.h>
12   -#import <Security/Security.h>
13   -#import <Security/SecureTransport.h>
14   -#import <dispatch/dispatch.h>
15   -#import <Availability.h>
16   -
17   -#include <sys/socket.h> // AF_INET, AF_INET6
18   -
19   -@class GCDAsyncReadPacket;
20   -@class GCDAsyncWritePacket;
21   -@class GCDAsyncSocketPreBuffer;
22   -@protocol GCDAsyncSocketDelegate;
23   -
24   -NS_ASSUME_NONNULL_BEGIN
25   -
26   -extern NSString *const GCDAsyncSocketException;
27   -extern NSString *const GCDAsyncSocketErrorDomain;
28   -
29   -extern NSString *const GCDAsyncSocketQueueName;
30   -extern NSString *const GCDAsyncSocketThreadName;
31   -
32   -extern NSString *const GCDAsyncSocketManuallyEvaluateTrust;
33   -#if TARGET_OS_IPHONE
34   -extern NSString *const GCDAsyncSocketUseCFStreamForTLS;
35   -#endif
36   -#define GCDAsyncSocketSSLPeerName (NSString *)kCFStreamSSLPeerName
37   -#define GCDAsyncSocketSSLCertificates (NSString *)kCFStreamSSLCertificates
38   -#define GCDAsyncSocketSSLIsServer (NSString *)kCFStreamSSLIsServer
39   -extern NSString *const GCDAsyncSocketSSLPeerID;
40   -extern NSString *const GCDAsyncSocketSSLProtocolVersionMin;
41   -extern NSString *const GCDAsyncSocketSSLProtocolVersionMax;
42   -extern NSString *const GCDAsyncSocketSSLSessionOptionFalseStart;
43   -extern NSString *const GCDAsyncSocketSSLSessionOptionSendOneByteRecord;
44   -extern NSString *const GCDAsyncSocketSSLCipherSuites;
45   -#if !TARGET_OS_IPHONE
46   -extern NSString *const GCDAsyncSocketSSLDiffieHellmanParameters;
47   -#endif
48   -
49   -#define GCDAsyncSocketLoggingContext 65535
50   -
51   -
52   -typedef NS_ENUM(NSInteger, GCDAsyncSocketError) {
53   - GCDAsyncSocketNoError = 0, // Never used
54   - GCDAsyncSocketBadConfigError, // Invalid configuration
55   - GCDAsyncSocketBadParamError, // Invalid parameter was passed
56   - GCDAsyncSocketConnectTimeoutError, // A connect operation timed out
57   - GCDAsyncSocketReadTimeoutError, // A read operation timed out
58   - GCDAsyncSocketWriteTimeoutError, // A write operation timed out
59   - GCDAsyncSocketReadMaxedOutError, // Reached set maxLength without completing
60   - GCDAsyncSocketClosedError, // The remote peer closed the connection
61   - GCDAsyncSocketOtherError, // Description provided in userInfo
62   -};
63   -
64   -////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
65   -#pragma mark -
66   -////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
67   -
68   -
69   -@interface GCDAsyncSocket : NSObject
70   -
71   -/**
72   - * GCDAsyncSocket uses the standard delegate paradigm,
73   - * but executes all delegate callbacks on a given delegate dispatch queue.
74   - * This allows for maximum concurrency, while at the same time providing easy thread safety.
75   - *
76   - * You MUST set a delegate AND delegate dispatch queue before attempting to
77   - * use the socket, or you will get an error.
78   - *
79   - * The socket queue is optional.
80   - * If you pass NULL, GCDAsyncSocket will automatically create it's own socket queue.
81   - * If you choose to provide a socket queue, the socket queue must not be a concurrent queue.
82   - * If you choose to provide a socket queue, and the socket queue has a configured target queue,
83   - * then please see the discussion for the method markSocketQueueTargetQueue.
84   - *
85   - * The delegate queue and socket queue can optionally be the same.
86   -**/
87   -- (instancetype)init;
88   -- (instancetype)initWithSocketQueue:(nullable dispatch_queue_t)sq;
89   -- (instancetype)initWithDelegate:(nullable id<GCDAsyncSocketDelegate>)aDelegate delegateQueue:(nullable dispatch_queue_t)dq;
90   -- (instancetype)initWithDelegate:(nullable id<GCDAsyncSocketDelegate>)aDelegate delegateQueue:(nullable dispatch_queue_t)dq socketQueue:(nullable dispatch_queue_t)sq;
91   -
92   -#pragma mark Configuration
93   -
94   -@property (atomic, weak, readwrite, nullable) id<GCDAsyncSocketDelegate> delegate;
95   -#if OS_OBJECT_USE_OBJC
96   -@property (atomic, strong, readwrite, nullable) dispatch_queue_t delegateQueue;
97   -#else
98   -@property (atomic, assign, readwrite, nullable) dispatch_queue_t delegateQueue;
99   -#endif
100   -
101   -- (void)getDelegate:(id<GCDAsyncSocketDelegate> __nullable * __nullable)delegatePtr delegateQueue:(dispatch_queue_t __nullable * __nullable)delegateQueuePtr;
102   -- (void)setDelegate:(nullable id<GCDAsyncSocketDelegate>)delegate delegateQueue:(nullable dispatch_queue_t)delegateQueue;
103   -
104   -/**
105   - * If you are setting the delegate to nil within the delegate's dealloc method,
106   - * you may need to use the synchronous versions below.
107   -**/
108   -- (void)synchronouslySetDelegate:(nullable id<GCDAsyncSocketDelegate>)delegate;
109   -- (void)synchronouslySetDelegateQueue:(nullable dispatch_queue_t)delegateQueue;
110   -- (void)synchronouslySetDelegate:(nullable id<GCDAsyncSocketDelegate>)delegate delegateQueue:(nullable dispatch_queue_t)delegateQueue;
111   -
112   -/**
113   - * By default, both IPv4 and IPv6 are enabled.
114   - *
115   - * For accepting incoming connections, this means GCDAsyncSocket automatically supports both protocols,
116   - * and can simulataneously accept incoming connections on either protocol.
117   - *
118   - * For outgoing connections, this means GCDAsyncSocket can connect to remote hosts running either protocol.
119   - * If a DNS lookup returns only IPv4 results, GCDAsyncSocket will automatically use IPv4.
120   - * If a DNS lookup returns only IPv6 results, GCDAsyncSocket will automatically use IPv6.
121   - * If a DNS lookup returns both IPv4 and IPv6 results, the preferred protocol will be chosen.
122   - * By default, the preferred protocol is IPv4, but may be configured as desired.
123   -**/
124   -
125   -@property (atomic, assign, readwrite, getter=isIPv4Enabled) BOOL IPv4Enabled;
126   -@property (atomic, assign, readwrite, getter=isIPv6Enabled) BOOL IPv6Enabled;
127   -
128   -@property (atomic, assign, readwrite, getter=isIPv4PreferredOverIPv6) BOOL IPv4PreferredOverIPv6;
129   -
130   -/**
131   - * When connecting to both IPv4 and IPv6 using Happy Eyeballs (RFC 6555) https://tools.ietf.org/html/rfc6555
132   - * this is the delay between connecting to the preferred protocol and the fallback protocol.
133   - *
134   - * Defaults to 300ms.
135   -**/
136   -@property (atomic, assign, readwrite) NSTimeInterval alternateAddressDelay;
137   -
138   -/**
139   - * User data allows you to associate arbitrary information with the socket.
140   - * This data is not used internally by socket in any way.
141   -**/
142   -@property (atomic, strong, readwrite, nullable) id userData;
143   -
144   -#pragma mark Accepting
145   -
146   -/**
147   - * Tells the socket to begin listening and accepting connections on the given port.
148   - * When a connection is accepted, a new instance of GCDAsyncSocket will be spawned to handle it,
149   - * and the socket:didAcceptNewSocket: delegate method will be invoked.
150   - *
151   - * The socket will listen on all available interfaces (e.g. wifi, ethernet, etc)
152   -**/
153   -- (BOOL)acceptOnPort:(uint16_t)port error:(NSError **)errPtr;
154   -
155   -/**
156   - * This method is the same as acceptOnPort:error: with the
157   - * additional option of specifying which interface to listen on.
158   - *
159   - * For example, you could specify that the socket should only accept connections over ethernet,
160   - * and not other interfaces such as wifi.
161   - *
162   - * The interface may be specified by name (e.g. "en1" or "lo0") or by IP address (e.g. "192.168.4.34").
163   - * You may also use the special strings "localhost" or "loopback" to specify that
164   - * the socket only accept connections from the local machine.
165   - *
166   - * You can see the list of interfaces via the command line utility "ifconfig",
167   - * or programmatically via the getifaddrs() function.
168   - *
169   - * To accept connections on any interface pass nil, or simply use the acceptOnPort:error: method.
170   -**/
171   -- (BOOL)acceptOnInterface:(nullable NSString *)interface port:(uint16_t)port error:(NSError **)errPtr;
172   -
173   -/**
174   - * Tells the socket to begin listening and accepting connections on the unix domain at the given url.
175   - * When a connection is accepted, a new instance of GCDAsyncSocket will be spawned to handle it,
176   - * and the socket:didAcceptNewSocket: delegate method will be invoked.
177   - *
178   - * The socket will listen on all available interfaces (e.g. wifi, ethernet, etc)
179   - **/
180   -- (BOOL)acceptOnUrl:(NSURL *)url error:(NSError **)errPtr;
181   -
182   -#pragma mark Connecting
183   -
184   -/**
185   - * Connects to the given host and port.
186   - *
187   - * This method invokes connectToHost:onPort:viaInterface:withTimeout:error:
188   - * and uses the default interface, and no timeout.
189   -**/
190   -- (BOOL)connectToHost:(NSString *)host onPort:(uint16_t)port error:(NSError **)errPtr;
191   -
192   -/**
193   - * Connects to the given host and port with an optional timeout.
194   - *
195   - * This method invokes connectToHost:onPort:viaInterface:withTimeout:error: and uses the default interface.
196   -**/
197   -- (BOOL)connectToHost:(NSString *)host
198   - onPort:(uint16_t)port
199   - withTimeout:(NSTimeInterval)timeout
200   - error:(NSError **)errPtr;
201   -
202   -/**
203   - * Connects to the given host & port, via the optional interface, with an optional timeout.
204   - *
205   - * The host may be a domain name (e.g. "deusty.com") or an IP address string (e.g. "192.168.0.2").
206   - * The host may also be the special strings "localhost" or "loopback" to specify connecting
207   - * to a service on the local machine.
208   - *
209   - * The interface may be a name (e.g. "en1" or "lo0") or the corresponding IP address (e.g. "192.168.4.35").
210   - * The interface may also be used to specify the local port (see below).
211   - *
212   - * To not time out use a negative time interval.
213   - *
214   - * This method will return NO if an error is detected, and set the error pointer (if one was given).
215   - * Possible errors would be a nil host, invalid interface, or socket is already connected.
216   - *
217   - * If no errors are detected, this method will start a background connect operation and immediately return YES.
218   - * The delegate callbacks are used to notify you when the socket connects, or if the host was unreachable.
219   - *
220   - * Since this class supports queued reads and writes, you can immediately start reading and/or writing.
221   - * All read/write operations will be queued, and upon socket connection,
222   - * the operations will be dequeued and processed in order.
223   - *
224   - * The interface may optionally contain a port number at the end of the string, separated by a colon.
225   - * This allows you to specify the local port that should be used for the outgoing connection. (read paragraph to end)
226   - * To specify both interface and local port: "en1:8082" or "192.168.4.35:2424".
227   - * To specify only local port: ":8082".
228   - * Please note this is an advanced feature, and is somewhat hidden on purpose.
229   - * You should understand that 99.999% of the time you should NOT specify the local port for an outgoing connection.
230   - * If you think you need to, there is a very good chance you have a fundamental misunderstanding somewhere.
231   - * Local ports do NOT need to match remote ports. In fact, they almost never do.
232   - * This feature is here for networking professionals using very advanced techniques.
233   -**/
234   -- (BOOL)connectToHost:(NSString *)host
235   - onPort:(uint16_t)port
236   - viaInterface:(nullable NSString *)interface
237   - withTimeout:(NSTimeInterval)timeout
238   - error:(NSError **)errPtr;
239   -
240   -/**
241   - * Connects to the given address, specified as a sockaddr structure wrapped in a NSData object.
242   - * For example, a NSData object returned from NSNetService's addresses method.
243   - *
244   - * If you have an existing struct sockaddr you can convert it to a NSData object like so:
245   - * struct sockaddr sa -> NSData *dsa = [NSData dataWithBytes:&remoteAddr length:remoteAddr.sa_len];
246   - * struct sockaddr *sa -> NSData *dsa = [NSData dataWithBytes:remoteAddr length:remoteAddr->sa_len];
247   - *
248   - * This method invokes connectToAdd
249   -**/
250   -- (BOOL)connectToAddress:(NSData *)remoteAddr error:(NSError **)errPtr;
251   -
252   -/**
253   - * This method is the same as connectToAddress:error: with an additional timeout option.
254   - * To not time out use a negative time interval, or simply use the connectToAddress:error: method.
255   -**/
256   -- (BOOL)connectToAddress:(NSData *)remoteAddr withTimeout:(NSTimeInterval)timeout error:(NSError **)errPtr;
257   -
258   -/**
259   - * Connects to the given address, using the specified interface and timeout.
260   - *
261   - * The address is specified as a sockaddr structure wrapped in a NSData object.
262   - * For example, a NSData object returned from NSNetService's addresses method.
263   - *
264   - * If you have an existing struct sockaddr you can convert it to a NSData object like so:
265   - * struct sockaddr sa -> NSData *dsa = [NSData dataWithBytes:&remoteAddr length:remoteAddr.sa_len];
266   - * struct sockaddr *sa -> NSData *dsa = [NSData dataWithBytes:remoteAddr length:remoteAddr->sa_len];
267   - *
268   - * The interface may be a name (e.g. "en1" or "lo0") or the corresponding IP address (e.g. "192.168.4.35").
269   - * The interface may also be used to specify the local port (see below).
270   - *
271   - * The timeout is optional. To not time out use a negative time interval.
272   - *
273   - * This method will return NO if an error is detected, and set the error pointer (if one was given).
274   - * Possible errors would be a nil host, invalid interface, or socket is already connected.
275   - *
276   - * If no errors are detected, this method will start a background connect operation and immediately return YES.
277   - * The delegate callbacks are used to notify you when the socket connects, or if the host was unreachable.
278   - *
279   - * Since this class supports queued reads and writes, you can immediately start reading and/or writing.
280   - * All read/write operations will be queued, and upon socket connection,
281   - * the operations will be dequeued and processed in order.
282   - *
283   - * The interface may optionally contain a port number at the end of the string, separated by a colon.
284   - * This allows you to specify the local port that should be used for the outgoing connection. (read paragraph to end)
285   - * To specify both interface and local port: "en1:8082" or "192.168.4.35:2424".
286   - * To specify only local port: ":8082".
287   - * Please note this is an advanced feature, and is somewhat hidden on purpose.
288   - * You should understand that 99.999% of the time you should NOT specify the local port for an outgoing connection.
289   - * If you think you need to, there is a very good chance you have a fundamental misunderstanding somewhere.
290   - * Local ports do NOT need to match remote ports. In fact, they almost never do.
291   - * This feature is here for networking professionals using very advanced techniques.
292   -**/
293   -- (BOOL)connectToAddress:(NSData *)remoteAddr
294   - viaInterface:(nullable NSString *)interface
295   - withTimeout:(NSTimeInterval)timeout
296   - error:(NSError **)errPtr;
297   -/**
298   - * Connects to the unix domain socket at the given url, using the specified timeout.
299   - */
300   -- (BOOL)connectToUrl:(NSURL *)url withTimeout:(NSTimeInterval)timeout error:(NSError **)errPtr;
301   -
302   -#pragma mark Disconnecting
303   -
304   -/**
305   - * Disconnects immediately (synchronously). Any pending reads or writes are dropped.
306   - *
307   - * If the socket is not already disconnected, an invocation to the socketDidDisconnect:withError: delegate method
308   - * will be queued onto the delegateQueue asynchronously (behind any previously queued delegate methods).
309   - * In other words, the disconnected delegate method will be invoked sometime shortly after this method returns.
310   - *
311   - * Please note the recommended way of releasing a GCDAsyncSocket instance (e.g. in a dealloc method)
312   - * [asyncSocket setDelegate:nil];
313   - * [asyncSocket disconnect];
314   - * [asyncSocket release];
315   - *
316   - * If you plan on disconnecting the socket, and then immediately asking it to connect again,
317   - * you'll likely want to do so like this:
318   - * [asyncSocket setDelegate:nil];
319   - * [asyncSocket disconnect];
320   - * [asyncSocket setDelegate:self];
321   - * [asyncSocket connect...];
322   -**/
323   -- (void)disconnect;
324   -
325   -/**
326   - * Disconnects after all pending reads have completed.
327   - * After calling this, the read and write methods will do nothing.
328   - * The socket will disconnect even if there are still pending writes.
329   -**/
330   -- (void)disconnectAfterReading;
331   -
332   -/**
333   - * Disconnects after all pending writes have completed.
334   - * After calling this, the read and write methods will do nothing.
335   - * The socket will disconnect even if there are still pending reads.
336   -**/
337   -- (void)disconnectAfterWriting;
338   -
339   -/**
340   - * Disconnects after all pending reads and writes have completed.
341   - * After calling this, the read and write methods will do nothing.
342   -**/
343   -- (void)disconnectAfterReadingAndWriting;
344   -
345   -#pragma mark Diagnostics
346   -
347   -/**
348   - * Returns whether the socket is disconnected or connected.
349   - *
350   - * A disconnected socket may be recycled.
351   - * That is, it can used again for connecting or listening.
352   - *
353   - * If a socket is in the process of connecting, it may be neither disconnected nor connected.
354   -**/
355   -@property (atomic, readonly) BOOL isDisconnected;
356   -@property (atomic, readonly) BOOL isConnected;
357   -
358   -/**
359   - * Returns the local or remote host and port to which this socket is connected, or nil and 0 if not connected.
360   - * The host will be an IP address.
361   -**/
362   -@property (atomic, readonly, nullable) NSString *connectedHost;
363   -@property (atomic, readonly) uint16_t connectedPort;
364   -@property (atomic, readonly, nullable) NSURL *connectedUrl;
365   -
366   -@property (atomic, readonly, nullable) NSString *localHost;
367   -@property (atomic, readonly) uint16_t localPort;
368   -
369   -/**
370   - * Returns the local or remote address to which this socket is connected,
371   - * specified as a sockaddr structure wrapped in a NSData object.
372   - *
373   - * @seealso connectedHost
374   - * @seealso connectedPort
375   - * @seealso localHost
376   - * @seealso localPort
377   -**/
378   -@property (atomic, readonly, nullable) NSData *connectedAddress;
379   -@property (atomic, readonly, nullable) NSData *localAddress;
380   -
381   -/**
382   - * Returns whether the socket is IPv4 or IPv6.
383   - * An accepting socket may be both.
384   -**/
385   -@property (atomic, readonly) BOOL isIPv4;
386   -@property (atomic, readonly) BOOL isIPv6;
387   -
388   -/**
389   - * Returns whether or not the socket has been secured via SSL/TLS.
390   - *
391   - * See also the startTLS method.
392   -**/
393   -@property (atomic, readonly) BOOL isSecure;
394   -
395   -#pragma mark Reading
396   -
397   -// The readData and writeData methods won't block (they are asynchronous).
398   -//
399   -// When a read is complete the socket:didReadData:withTag: delegate method is dispatched on the delegateQueue.
400   -// When a write is complete the socket:didWriteDataWithTag: delegate method is dispatched on the delegateQueue.
401   -//
402   -// You may optionally set a timeout for any read/write operation. (To not timeout, use a negative time interval.)
403   -// If a read/write opertion times out, the corresponding "socket:shouldTimeout..." delegate method
404   -// is called to optionally allow you to extend the timeout.
405   -// Upon a timeout, the "socket:didDisconnectWithError:" method is called
406   -//
407   -// The tag is for your convenience.
408   -// You can use it as an array index, step number, state id, pointer, etc.
409   -
410   -/**
411   - * Reads the first available bytes that become available on the socket.
412   - *
413   - * If the timeout value is negative, the read operation will not use a timeout.
414   -**/
415   -- (void)readDataWithTimeout:(NSTimeInterval)timeout tag:(long)tag;
416   -
417   -/**
418   - * Reads the first available bytes that become available on the socket.
419   - * The bytes will be appended to the given byte buffer starting at the given offset.
420   - * The given buffer will automatically be increased in size if needed.
421   - *
422   - * If the timeout value is negative, the read operation will not use a timeout.
423   - * If the buffer if nil, the socket will create a buffer for you.
424   - *
425   - * If the bufferOffset is greater than the length of the given buffer,
426   - * the method will do nothing, and the delegate will not be called.
427   - *
428   - * If you pass a buffer, you must not alter it in any way while the socket is using it.
429   - * After completion, the data returned in socket:didReadData:withTag: will be a subset of the given buffer.
430   - * That is, it will reference the bytes that were appended to the given buffer via
431   - * the method [NSData dataWithBytesNoCopy:length:freeWhenDone:NO].
432   -**/
433   -- (void)readDataWithTimeout:(NSTimeInterval)timeout
434   - buffer:(nullable NSMutableData *)buffer
435   - bufferOffset:(NSUInteger)offset
436   - tag:(long)tag;
437   -
438   -/**
439   - * Reads the first available bytes that become available on the socket.
440   - * The bytes will be appended to the given byte buffer starting at the given offset.
441   - * The given buffer will automatically be increased in size if needed.
442   - * A maximum of length bytes will be read.
443   - *
444   - * If the timeout value is negative, the read operation will not use a timeout.
445   - * If the buffer if nil, a buffer will automatically be created for you.
446   - * If maxLength is zero, no length restriction is enforced.
447   - *
448   - * If the bufferOffset is greater than the length of the given buffer,
449   - * the method will do nothing, and the delegate will not be called.
450   - *
451   - * If you pass a buffer, you must not alter it in any way while the socket is using it.
452   - * After completion, the data returned in socket:didReadData:withTag: will be a subset of the given buffer.
453   - * That is, it will reference the bytes that were appended to the given buffer via
454   - * the method [NSData dataWithBytesNoCopy:length:freeWhenDone:NO].
455   -**/
456   -- (void)readDataWithTimeout:(NSTimeInterval)timeout
457   - buffer:(nullable NSMutableData *)buffer
458   - bufferOffset:(NSUInteger)offset
459   - maxLength:(NSUInteger)length
460   - tag:(long)tag;
461   -
462   -/**
463   - * Reads the given number of bytes.
464   - *
465   - * If the timeout value is negative, the read operation will not use a timeout.
466   - *
467   - * If the length is 0, this method does nothing and the delegate is not called.
468   -**/
469   -- (void)readDataToLength:(NSUInteger)length withTimeout:(NSTimeInterval)timeout tag:(long)tag;
470   -
471   -/**
472   - * Reads the given number of bytes.
473   - * The bytes will be appended to the given byte buffer starting at the given offset.
474   - * The given buffer will automatically be increased in size if needed.
475   - *
476   - * If the timeout value is negative, the read operation will not use a timeout.
477   - * If the buffer if nil, a buffer will automatically be created for you.
478   - *
479   - * If the length is 0, this method does nothing and the delegate is not called.
480   - * If the bufferOffset is greater than the length of the given buffer,
481   - * the method will do nothing, and the delegate will not be called.
482   - *
483   - * If you pass a buffer, you must not alter it in any way while AsyncSocket is using it.
484   - * After completion, the data returned in socket:didReadData:withTag: will be a subset of the given buffer.
485   - * That is, it will reference the bytes that were appended to the given buffer via
486   - * the method [NSData dataWithBytesNoCopy:length:freeWhenDone:NO].
487   -**/
488   -- (void)readDataToLength:(NSUInteger)length
489   - withTimeout:(NSTimeInterval)timeout
490   - buffer:(nullable NSMutableData *)buffer
491   - bufferOffset:(NSUInteger)offset
492   - tag:(long)tag;
493   -
494   -/**
495   - * Reads bytes until (and including) the passed "data" parameter, which acts as a separator.
496   - *
497   - * If the timeout value is negative, the read operation will not use a timeout.
498   - *
499   - * If you pass nil or zero-length data as the "data" parameter,
500   - * the method will do nothing (except maybe print a warning), and the delegate will not be called.
501   - *
502   - * To read a line from the socket, use the line separator (e.g. CRLF for HTTP, see below) as the "data" parameter.
503   - * If you're developing your own custom protocol, be sure your separator can not occur naturally as
504   - * part of the data between separators.
505   - * For example, imagine you want to send several small documents over a socket.
506   - * Using CRLF as a separator is likely unwise, as a CRLF could easily exist within the documents.
507   - * In this particular example, it would be better to use a protocol similar to HTTP with
508   - * a header that includes the length of the document.
509   - * Also be careful that your separator cannot occur naturally as part of the encoding for a character.
510   - *
511   - * The given data (separator) parameter should be immutable.
512   - * For performance reasons, the socket will retain it, not copy it.
513   - * So if it is immutable, don't modify it while the socket is using it.
514   -**/
515   -- (void)readDataToData:(NSData *)data withTimeout:(NSTimeInterval)timeout tag:(long)tag;
516   -
517   -/**
518   - * Reads bytes until (and including) the passed "data" parameter, which acts as a separator.
519   - * The bytes will be appended to the given byte buffer starting at the given offset.
520   - * The given buffer will automatically be increased in size if needed.
521   - *
522   - * If the timeout value is negative, the read operation will not use a timeout.
523   - * If the buffer if nil, a buffer will automatically be created for you.
524   - *
525   - * If the bufferOffset is greater than the length of the given buffer,
526   - * the method will do nothing (except maybe print a warning), and the delegate will not be called.
527   - *
528   - * If you pass a buffer, you must not alter it in any way while the socket is using it.
529   - * After completion, the data returned in socket:didReadData:withTag: will be a subset of the given buffer.
530   - * That is, it will reference the bytes that were appended to the given buffer via
531   - * the method [NSData dataWithBytesNoCopy:length:freeWhenDone:NO].
532   - *
533   - * To read a line from the socket, use the line separator (e.g. CRLF for HTTP, see below) as the "data" parameter.
534   - * If you're developing your own custom protocol, be sure your separator can not occur naturally as
535   - * part of the data between separators.
536   - * For example, imagine you want to send several small documents over a socket.
537   - * Using CRLF as a separator is likely unwise, as a CRLF could easily exist within the documents.
538   - * In this particular example, it would be better to use a protocol similar to HTTP with
539   - * a header that includes the length of the document.
540   - * Also be careful that your separator cannot occur naturally as part of the encoding for a character.
541   - *
542   - * The given data (separator) parameter should be immutable.
543   - * For performance reasons, the socket will retain it, not copy it.
544   - * So if it is immutable, don't modify it while the socket is using it.
545   -**/
546   -- (void)readDataToData:(NSData *)data
547   - withTimeout:(NSTimeInterval)timeout
548   - buffer:(nullable NSMutableData *)buffer
549   - bufferOffset:(NSUInteger)offset
550   - tag:(long)tag;
551   -
552   -/**
553   - * Reads bytes until (and including) the passed "data" parameter, which acts as a separator.
554   - *
555   - * If the timeout value is negative, the read operation will not use a timeout.
556   - *
557   - * If maxLength is zero, no length restriction is enforced.
558   - * Otherwise if maxLength bytes are read without completing the read,
559   - * it is treated similarly to a timeout - the socket is closed with a GCDAsyncSocketReadMaxedOutError.
560   - * The read will complete successfully if exactly maxLength bytes are read and the given data is found at the end.
561   - *
562   - * If you pass nil or zero-length data as the "data" parameter,
563   - * the method will do nothing (except maybe print a warning), and the delegate will not be called.
564   - * If you pass a maxLength parameter that is less than the length of the data parameter,
565   - * the method will do nothing (except maybe print a warning), and the delegate will not be called.
566   - *
567   - * To read a line from the socket, use the line separator (e.g. CRLF for HTTP, see below) as the "data" parameter.
568   - * If you're developing your own custom protocol, be sure your separator can not occur naturally as
569   - * part of the data between separators.
570   - * For example, imagine you want to send several small documents over a socket.
571   - * Using CRLF as a separator is likely unwise, as a CRLF could easily exist within the documents.
572   - * In this particular example, it would be better to use a protocol similar to HTTP with
573   - * a header that includes the length of the document.
574   - * Also be careful that your separator cannot occur naturally as part of the encoding for a character.
575   - *
576   - * The given data (separator) parameter should be immutable.
577   - * For performance reasons, the socket will retain it, not copy it.
578   - * So if it is immutable, don't modify it while the socket is using it.
579   -**/
580   -- (void)readDataToData:(NSData *)data withTimeout:(NSTimeInterval)timeout maxLength:(NSUInteger)length tag:(long)tag;
581   -
582   -/**
583   - * Reads bytes until (and including) the passed "data" parameter, which acts as a separator.
584   - * The bytes will be appended to the given byte buffer starting at the given offset.
585   - * The given buffer will automatically be increased in size if needed.
586   - *
587   - * If the timeout value is negative, the read operation will not use a timeout.
588   - * If the buffer if nil, a buffer will automatically be created for you.
589   - *
590   - * If maxLength is zero, no length restriction is enforced.
591   - * Otherwise if maxLength bytes are read without completing the read,
592   - * it is treated similarly to a timeout - the socket is closed with a GCDAsyncSocketReadMaxedOutError.
593   - * The read will complete successfully if exactly maxLength bytes are read and the given data is found at the end.
594   - *
595   - * If you pass a maxLength parameter that is less than the length of the data (separator) parameter,
596   - * the method will do nothing (except maybe print a warning), and the delegate will not be called.
597   - * If the bufferOffset is greater than the length of the given buffer,
598   - * the method will do nothing (except maybe print a warning), and the delegate will not be called.
599   - *
600   - * If you pass a buffer, you must not alter it in any way while the socket is using it.
601   - * After completion, the data returned in socket:didReadData:withTag: will be a subset of the given buffer.
602   - * That is, it will reference the bytes that were appended to the given buffer via
603   - * the method [NSData dataWithBytesNoCopy:length:freeWhenDone:NO].
604   - *
605   - * To read a line from the socket, use the line separator (e.g. CRLF for HTTP, see below) as the "data" parameter.
606   - * If you're developing your own custom protocol, be sure your separator can not occur naturally as
607   - * part of the data between separators.
608   - * For example, imagine you want to send several small documents over a socket.
609   - * Using CRLF as a separator is likely unwise, as a CRLF could easily exist within the documents.
610   - * In this particular example, it would be better to use a protocol similar to HTTP with
611   - * a header that includes the length of the document.
612   - * Also be careful that your separator cannot occur naturally as part of the encoding for a character.
613   - *
614   - * The given data (separator) parameter should be immutable.
615   - * For performance reasons, the socket will retain it, not copy it.
616   - * So if it is immutable, don't modify it while the socket is using it.
617   -**/
618   -- (void)readDataToData:(NSData *)data
619   - withTimeout:(NSTimeInterval)timeout
620   - buffer:(nullable NSMutableData *)buffer
621   - bufferOffset:(NSUInteger)offset
622   - maxLength:(NSUInteger)length
623   - tag:(long)tag;
624   -
625   -/**
626   - * Returns progress of the current read, from 0.0 to 1.0, or NaN if no current read (use isnan() to check).
627   - * The parameters "tag", "done" and "total" will be filled in if they aren't NULL.
628   -**/
629   -- (float)progressOfReadReturningTag:(nullable long *)tagPtr bytesDone:(nullable NSUInteger *)donePtr total:(nullable NSUInteger *)totalPtr;
630   -
631   -#pragma mark Writing
632   -
633   -/**
634   - * Writes data to the socket, and calls the delegate when finished.
635   - *
636   - * If you pass in nil or zero-length data, this method does nothing and the delegate will not be called.
637   - * If the timeout value is negative, the write operation will not use a timeout.
638   - *
639   - * Thread-Safety Note:
640   - * If the given data parameter is mutable (NSMutableData) then you MUST NOT alter the data while
641   - * the socket is writing it. In other words, it's not safe to alter the data until after the delegate method
642   - * socket:didWriteDataWithTag: is invoked signifying that this particular write operation has completed.
643   - * This is due to the fact that GCDAsyncSocket does NOT copy the data. It simply retains it.
644   - * This is for performance reasons. Often times, if NSMutableData is passed, it is because
645   - * a request/response was built up in memory. Copying this data adds an unwanted/unneeded overhead.
646   - * If you need to write data from an immutable buffer, and you need to alter the buffer before the socket
647   - * completes writing the bytes (which is NOT immediately after this method returns, but rather at a later time
648   - * when the delegate method notifies you), then you should first copy the bytes, and pass the copy to this method.
649   -**/
650   -- (void)writeData:(NSData *)data withTimeout:(NSTimeInterval)timeout tag:(long)tag;
651   -
652   -/**
653   - * Returns progress of the current write, from 0.0 to 1.0, or NaN if no current write (use isnan() to check).
654   - * The parameters "tag", "done" and "total" will be filled in if they aren't NULL.
655   -**/
656   -- (float)progressOfWriteReturningTag:(nullable long *)tagPtr bytesDone:(nullable NSUInteger *)donePtr total:(nullable NSUInteger *)totalPtr;
657   -
658   -#pragma mark Security
659   -
660   -/**
661   - * Secures the connection using SSL/TLS.
662   - *
663   - * This method may be called at any time, and the TLS handshake will occur after all pending reads and writes
664   - * are finished. This allows one the option of sending a protocol dependent StartTLS message, and queuing
665   - * the upgrade to TLS at the same time, without having to wait for the write to finish.
666   - * Any reads or writes scheduled after this method is called will occur over the secured connection.
667   - *
668   - * ==== The available TOP-LEVEL KEYS are:
669   - *
670   - * - GCDAsyncSocketManuallyEvaluateTrust
671   - * The value must be of type NSNumber, encapsulating a BOOL value.
672   - * If you set this to YES, then the underlying SecureTransport system will not evaluate the SecTrustRef of the peer.
673   - * Instead it will pause at the moment evaulation would typically occur,
674   - * and allow us to handle the security evaluation however we see fit.
675   - * So GCDAsyncSocket will invoke the delegate method socket:shouldTrustPeer: passing the SecTrustRef.
676   - *
677   - * Note that if you set this option, then all other configuration keys are ignored.
678   - * Evaluation will be completely up to you during the socket:didReceiveTrust:completionHandler: delegate method.
679   - *
680   - * For more information on trust evaluation see:
681   - * Apple's Technical Note TN2232 - HTTPS Server Trust Evaluation
682   - * https://developer.apple.com/library/ios/technotes/tn2232/_index.html
683   - *
684   - * If unspecified, the default value is NO.
685   - *
686   - * - GCDAsyncSocketUseCFStreamForTLS (iOS only)
687   - * The value must be of type NSNumber, encapsulating a BOOL value.
688   - * By default GCDAsyncSocket will use the SecureTransport layer to perform encryption.
689   - * This gives us more control over the security protocol (many more configuration options),
690   - * plus it allows us to optimize things like sys calls and buffer allocation.
691   - *
692   - * However, if you absolutely must, you can instruct GCDAsyncSocket to use the old-fashioned encryption
693   - * technique by going through the CFStream instead. So instead of using SecureTransport, GCDAsyncSocket
694   - * will instead setup a CFRead/CFWriteStream. And then set the kCFStreamPropertySSLSettings property
695   - * (via CFReadStreamSetProperty / CFWriteStreamSetProperty) and will pass the given options to this method.
696   - *
697   - * Thus all the other keys in the given dictionary will be ignored by GCDAsyncSocket,
698   - * and will passed directly CFReadStreamSetProperty / CFWriteStreamSetProperty.
699   - * For more infomation on these keys, please see the documentation for kCFStreamPropertySSLSettings.
700   - *
701   - * If unspecified, the default value is NO.
702   - *
703   - * ==== The available CONFIGURATION KEYS are:
704   - *
705   - * - kCFStreamSSLPeerName
706   - * The value must be of type NSString.
707   - * It should match the name in the X.509 certificate given by the remote party.
708   - * See Apple's documentation for SSLSetPeerDomainName.
709   - *
710   - * - kCFStreamSSLCertificates
711   - * The value must be of type NSArray.
712   - * See Apple's documentation for SSLSetCertificate.
713   - *
714   - * - kCFStreamSSLIsServer
715   - * The value must be of type NSNumber, encapsulationg a BOOL value.
716   - * See Apple's documentation for SSLCreateContext for iOS.
717   - * This is optional for iOS. If not supplied, a NO value is the default.
718   - * This is not needed for Mac OS X, and the value is ignored.
719   - *
720   - * - GCDAsyncSocketSSLPeerID
721   - * The value must be of type NSData.
722   - * You must set this value if you want to use TLS session resumption.
723   - * See Apple's documentation for SSLSetPeerID.
724   - *
725   - * - GCDAsyncSocketSSLProtocolVersionMin
726   - * - GCDAsyncSocketSSLProtocolVersionMax
727   - * The value(s) must be of type NSNumber, encapsulting a SSLProtocol value.
728   - * See Apple's documentation for SSLSetProtocolVersionMin & SSLSetProtocolVersionMax.
729   - * See also the SSLProtocol typedef.
730   - *
731   - * - GCDAsyncSocketSSLSessionOptionFalseStart
732   - * The value must be of type NSNumber, encapsulating a BOOL value.
733   - * See Apple's documentation for kSSLSessionOptionFalseStart.
734   - *
735   - * - GCDAsyncSocketSSLSessionOptionSendOneByteRecord
736   - * The value must be of type NSNumber, encapsulating a BOOL value.
737   - * See Apple's documentation for kSSLSessionOptionSendOneByteRecord.
738   - *
739   - * - GCDAsyncSocketSSLCipherSuites
740   - * The values must be of type NSArray.
741   - * Each item within the array must be a NSNumber, encapsulating
742   - * See Apple's documentation for SSLSetEnabledCiphers.
743   - * See also the SSLCipherSuite typedef.
744   - *
745   - * - GCDAsyncSocketSSLDiffieHellmanParameters (Mac OS X only)
746   - * The value must be of type NSData.
747   - * See Apple's documentation for SSLSetDiffieHellmanParams.
748   - *
749   - * ==== The following UNAVAILABLE KEYS are: (with throw an exception)
750   - *
751   - * - kCFStreamSSLAllowsAnyRoot (UNAVAILABLE)
752   - * You MUST use manual trust evaluation instead (see GCDAsyncSocketManuallyEvaluateTrust).
753   - * Corresponding deprecated method: SSLSetAllowsAnyRoot
754   - *
755   - * - kCFStreamSSLAllowsExpiredRoots (UNAVAILABLE)
756   - * You MUST use manual trust evaluation instead (see GCDAsyncSocketManuallyEvaluateTrust).
757   - * Corresponding deprecated method: SSLSetAllowsExpiredRoots
758   - *
759   - * - kCFStreamSSLAllowsExpiredCertificates (UNAVAILABLE)
760   - * You MUST use manual trust evaluation instead (see GCDAsyncSocketManuallyEvaluateTrust).
761   - * Corresponding deprecated method: SSLSetAllowsExpiredCerts
762   - *
763   - * - kCFStreamSSLValidatesCertificateChain (UNAVAILABLE)
764   - * You MUST use manual trust evaluation instead (see GCDAsyncSocketManuallyEvaluateTrust).
765   - * Corresponding deprecated method: SSLSetEnableCertVerify
766   - *
767   - * - kCFStreamSSLLevel (UNAVAILABLE)
768   - * You MUST use GCDAsyncSocketSSLProtocolVersionMin & GCDAsyncSocketSSLProtocolVersionMin instead.
769   - * Corresponding deprecated method: SSLSetProtocolVersionEnabled
770   - *
771   - *
772   - * Please refer to Apple's documentation for corresponding SSLFunctions.
773   - *
774   - * If you pass in nil or an empty dictionary, the default settings will be used.
775   - *
776   - * IMPORTANT SECURITY NOTE:
777   - * The default settings will check to make sure the remote party's certificate is signed by a
778   - * trusted 3rd party certificate agency (e.g. verisign) and that the certificate is not expired.
779   - * However it will not verify the name on the certificate unless you
780   - * give it a name to verify against via the kCFStreamSSLPeerName key.
781   - * The security implications of this are important to understand.
782   - * Imagine you are attempting to create a secure connection to MySecureServer.com,
783   - * but your socket gets directed to MaliciousServer.com because of a hacked DNS server.
784   - * If you simply use the default settings, and MaliciousServer.com has a valid certificate,
785   - * the default settings will not detect any problems since the certificate is valid.
786   - * To properly secure your connection in this particular scenario you
787   - * should set the kCFStreamSSLPeerName property to "MySecureServer.com".
788   - *
789   - * You can also perform additional validation in socketDidSecure.
790   -**/
791   -- (void)startTLS:(nullable NSDictionary <NSString*,NSNumber*>*)tlsSettings;
792   -
793   -#pragma mark Advanced
794   -
795   -/**
796   - * Traditionally sockets are not closed until the conversation is over.
797   - * However, it is technically possible for the remote enpoint to close its write stream.
798   - * Our socket would then be notified that there is no more data to be read,
799   - * but our socket would still be writeable and the remote endpoint could continue to receive our data.
800   - *
801   - * The argument for this confusing functionality stems from the idea that a client could shut down its
802   - * write stream after sending a request to the server, thus notifying the server there are to be no further requests.
803   - * In practice, however, this technique did little to help server developers.
804   - *
805   - * To make matters worse, from a TCP perspective there is no way to tell the difference from a read stream close
806   - * and a full socket close. They both result in the TCP stack receiving a FIN packet. The only way to tell
807   - * is by continuing to write to the socket. If it was only a read stream close, then writes will continue to work.
808   - * Otherwise an error will be occur shortly (when the remote end sends us a RST packet).
809   - *
810   - * In addition to the technical challenges and confusion, many high level socket/stream API's provide
811   - * no support for dealing with the problem. If the read stream is closed, the API immediately declares the
812   - * socket to be closed, and shuts down the write stream as well. In fact, this is what Apple's CFStream API does.
813   - * It might sound like poor design at first, but in fact it simplifies development.
814   - *
815   - * The vast majority of the time if the read stream is closed it's because the remote endpoint closed its socket.
816   - * Thus it actually makes sense to close the socket at this point.
817   - * And in fact this is what most networking developers want and expect to happen.
818   - * However, if you are writing a server that interacts with a plethora of clients,
819   - * you might encounter a client that uses the discouraged technique of shutting down its write stream.
820   - * If this is the case, you can set this property to NO,
821   - * and make use of the socketDidCloseReadStream delegate method.
822   - *
823   - * The default value is YES.
824   -**/
825   -@property (atomic, assign, readwrite) BOOL autoDisconnectOnClosedReadStream;
826   -
827   -/**
828   - * GCDAsyncSocket maintains thread safety by using an internal serial dispatch_queue.
829   - * In most cases, the instance creates this queue itself.
830   - * However, to allow for maximum flexibility, the internal queue may be passed in the init method.
831   - * This allows for some advanced options such as controlling socket priority via target queues.
832   - * However, when one begins to use target queues like this, they open the door to some specific deadlock issues.
833   - *
834   - * For example, imagine there are 2 queues:
835   - * dispatch_queue_t socketQueue;
836   - * dispatch_queue_t socketTargetQueue;
837   - *
838   - * If you do this (pseudo-code):
839   - * socketQueue.targetQueue = socketTargetQueue;
840   - *
841   - * Then all socketQueue operations will actually get run on the given socketTargetQueue.
842   - * This is fine and works great in most situations.
843   - * But if you run code directly from within the socketTargetQueue that accesses the socket,
844   - * you could potentially get deadlock. Imagine the following code:
845   - *
846   - * - (BOOL)socketHasSomething
847   - * {
848   - * __block BOOL result = NO;
849   - * dispatch_block_t block = ^{
850   - * result = [self someInternalMethodToBeRunOnlyOnSocketQueue];
851   - * }
852   - * if (is_executing_on_queue(socketQueue))
853   - * block();
854   - * else
855   - * dispatch_sync(socketQueue, block);
856   - *
857   - * return result;
858   - * }
859   - *
860   - * What happens if you call this method from the socketTargetQueue? The result is deadlock.
861   - * This is because the GCD API offers no mechanism to discover a queue's targetQueue.
862   - * Thus we have no idea if our socketQueue is configured with a targetQueue.
863   - * If we had this information, we could easily avoid deadlock.
864   - * But, since these API's are missing or unfeasible, you'll have to explicitly set it.
865   - *
866   - * IF you pass a socketQueue via the init method,
867   - * AND you've configured the passed socketQueue with a targetQueue,
868   - * THEN you should pass the end queue in the target hierarchy.
869   - *
870   - * For example, consider the following queue hierarchy:
871   - * socketQueue -> ipQueue -> moduleQueue
872   - *
873   - * This example demonstrates priority shaping within some server.
874   - * All incoming client connections from the same IP address are executed on the same target queue.
875   - * And all connections for a particular module are executed on the same target queue.
876   - * Thus, the priority of all networking for the entire module can be changed on the fly.
877   - * Additionally, networking traffic from a single IP cannot monopolize the module.
878   - *
879   - * Here's how you would accomplish something like that:
880   - * - (dispatch_queue_t)newSocketQueueForConnectionFromAddress:(NSData *)address onSocket:(GCDAsyncSocket *)sock
881   - * {
882   - * dispatch_queue_t socketQueue = dispatch_queue_create("", NULL);
883   - * dispatch_queue_t ipQueue = [self ipQueueForAddress:address];
884   - *
885   - * dispatch_set_target_queue(socketQueue, ipQueue);
886   - * dispatch_set_target_queue(iqQueue, moduleQueue);
887   - *
888   - * return socketQueue;
889   - * }
890   - * - (void)socket:(GCDAsyncSocket *)sock didAcceptNewSocket:(GCDAsyncSocket *)newSocket
891   - * {
892   - * [clientConnections addObject:newSocket];
893   - * [newSocket markSocketQueueTargetQueue:moduleQueue];
894   - * }
895   - *
896   - * Note: This workaround is ONLY needed if you intend to execute code directly on the ipQueue or moduleQueue.
897   - * This is often NOT the case, as such queues are used solely for execution shaping.
898   -**/
899   -- (void)markSocketQueueTargetQueue:(dispatch_queue_t)socketQueuesPreConfiguredTargetQueue;
900   -- (void)unmarkSocketQueueTargetQueue:(dispatch_queue_t)socketQueuesPreviouslyConfiguredTargetQueue;
901   -
902   -/**
903   - * It's not thread-safe to access certain variables from outside the socket's internal queue.
904   - *
905   - * For example, the socket file descriptor.
906   - * File descriptors are simply integers which reference an index in the per-process file table.
907   - * However, when one requests a new file descriptor (by opening a file or socket),
908   - * the file descriptor returned is guaranteed to be the lowest numbered unused descriptor.
909   - * So if we're not careful, the following could be possible:
910   - *
911   - * - Thread A invokes a method which returns the socket's file descriptor.
912   - * - The socket is closed via the socket's internal queue on thread B.
913   - * - Thread C opens a file, and subsequently receives the file descriptor that was previously the socket's FD.
914   - * - Thread A is now accessing/altering the file instead of the socket.
915   - *
916   - * In addition to this, other variables are not actually objects,
917   - * and thus cannot be retained/released or even autoreleased.
918   - * An example is the sslContext, of type SSLContextRef, which is actually a malloc'd struct.
919   - *
920   - * Although there are internal variables that make it difficult to maintain thread-safety,
921   - * it is important to provide access to these variables
922   - * to ensure this class can be used in a wide array of environments.
923   - * This method helps to accomplish this by invoking the current block on the socket's internal queue.
924   - * The methods below can be invoked from within the block to access
925   - * those generally thread-unsafe internal variables in a thread-safe manner.
926   - * The given block will be invoked synchronously on the socket's internal queue.
927   - *
928   - * If you save references to any protected variables and use them outside the block, you do so at your own peril.
929   -**/
930   -- (void)performBlock:(dispatch_block_t)block;
931   -
932   -/**
933   - * These methods are only available from within the context of a performBlock: invocation.
934   - * See the documentation for the performBlock: method above.
935   - *
936   - * Provides access to the socket's file descriptor(s).
937   - * If the socket is a server socket (is accepting incoming connections),
938   - * it might actually have multiple internal socket file descriptors - one for IPv4 and one for IPv6.
939   -**/
940   -- (int)socketFD;
941   -- (int)socket4FD;
942   -- (int)socket6FD;
943   -
944   -#if TARGET_OS_IPHONE
945   -
946   -/**
947   - * These methods are only available from within the context of a performBlock: invocation.
948   - * See the documentation for the performBlock: method above.
949   - *
950   - * Provides access to the socket's internal CFReadStream/CFWriteStream.
951   - *
952   - * These streams are only used as workarounds for specific iOS shortcomings:
953   - *
954   - * - Apple has decided to keep the SecureTransport framework private is iOS.
955   - * This means the only supplied way to do SSL/TLS is via CFStream or some other API layered on top of it.
956   - * Thus, in order to provide SSL/TLS support on iOS we are forced to rely on CFStream,
957   - * instead of the preferred and faster and more powerful SecureTransport.
958   - *
959   - * - If a socket doesn't have backgrounding enabled, and that socket is closed while the app is backgrounded,
960   - * Apple only bothers to notify us via the CFStream API.
961   - * The faster and more powerful GCD API isn't notified properly in this case.
962   - *
963   - * See also: (BOOL)enableBackgroundingOnSocket
964   -**/
965   -- (CFReadStreamRef)readStream;
966   -- (CFWriteStreamRef)writeStream;
967   -
968   -/**
969   - * This method is only available from within the context of a performBlock: invocation.
970   - * See the documentation for the performBlock: method above.
971   - *
972   - * Configures the socket to allow it to operate when the iOS application has been backgrounded.
973   - * In other words, this method creates a read & write stream, and invokes:
974   - *
975   - * CFReadStreamSetProperty(readStream, kCFStreamNetworkServiceType, kCFStreamNetworkServiceTypeVoIP);
976   - * CFWriteStreamSetProperty(writeStream, kCFStreamNetworkServiceType, kCFStreamNetworkServiceTypeVoIP);
977   - *
978   - * Returns YES if successful, NO otherwise.
979   - *
980   - * Note: Apple does not officially support backgrounding server sockets.
981   - * That is, if your socket is accepting incoming connections, Apple does not officially support
982   - * allowing iOS applications to accept incoming connections while an app is backgrounded.
983   - *
984   - * Example usage:
985   - *
986   - * - (void)socket:(GCDAsyncSocket *)sock didConnectToHost:(NSString *)host port:(uint16_t)port
987   - * {
988   - * [asyncSocket performBlock:^{
989   - * [asyncSocket enableBackgroundingOnSocket];
990   - * }];
991   - * }
992   -**/
993   -- (BOOL)enableBackgroundingOnSocket;
994   -
995   -#endif
996   -
997   -/**
998   - * This method is only available from within the context of a performBlock: invocation.
999   - * See the documentation for the performBlock: method above.
1000   - *
1001   - * Provides access to the socket's SSLContext, if SSL/TLS has been started on the socket.
1002   -**/
1003   -- (SSLContextRef)sslContext;
1004   -
1005   -#pragma mark Utilities
1006   -
1007   -/**
1008   - * The address lookup utility used by the class.
1009   - * This method is synchronous, so it's recommended you use it on a background thread/queue.
1010   - *
1011   - * The special strings "localhost" and "loopback" return the loopback address for IPv4 and IPv6.
1012   - *
1013   - * @returns
1014   - * A mutable array with all IPv4 and IPv6 addresses returned by getaddrinfo.
1015   - * The addresses are specifically for TCP connections.
1016   - * You can filter the addresses, if needed, using the other utility methods provided by the class.
1017   -**/
1018   -+ (nullable NSMutableArray *)lookupHost:(NSString *)host port:(uint16_t)port error:(NSError **)errPtr;
1019   -
1020   -/**
1021   - * Extracting host and port information from raw address data.
1022   -**/
1023   -
1024   -+ (nullable NSString *)hostFromAddress:(NSData *)address;
1025   -+ (uint16_t)portFromAddress:(NSData *)address;
1026   -
1027   -+ (BOOL)isIPv4Address:(NSData *)address;
1028   -+ (BOOL)isIPv6Address:(NSData *)address;
1029   -
1030   -+ (BOOL)getHost:( NSString * __nullable * __nullable)hostPtr port:(nullable uint16_t *)portPtr fromAddress:(NSData *)address;
1031   -
1032   -+ (BOOL)getHost:(NSString * __nullable * __nullable)hostPtr port:(nullable uint16_t *)portPtr family:(nullable sa_family_t *)afPtr fromAddress:(NSData *)address;
1033   -
1034   -/**
1035   - * A few common line separators, for use with the readDataToData:... methods.
1036   -**/
1037   -+ (NSData *)CRLFData; // 0x0D0A
1038   -+ (NSData *)CRData; // 0x0D
1039   -+ (NSData *)LFData; // 0x0A
1040   -+ (NSData *)ZeroData; // 0x00
1041   -
1042   -@end
1043   -
1044   -////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
1045   -#pragma mark -
1046   -////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
1047   -
1048   -@protocol GCDAsyncSocketDelegate
1049   -@optional
1050   -
1051   -/**
1052   - * This method is called immediately prior to socket:didAcceptNewSocket:.
1053   - * It optionally allows a listening socket to specify the socketQueue for a new accepted socket.
1054   - * If this method is not implemented, or returns NULL, the new accepted socket will create its own default queue.
1055   - *
1056   - * Since you cannot autorelease a dispatch_queue,
1057   - * this method uses the "new" prefix in its name to specify that the returned queue has been retained.
1058   - *
1059   - * Thus you could do something like this in the implementation:
1060   - * return dispatch_queue_create("MyQueue", NULL);
1061   - *
1062   - * If you are placing multiple sockets on the same queue,
1063   - * then care should be taken to increment the retain count each time this method is invoked.
1064   - *
1065   - * For example, your implementation might look something like this:
1066   - * dispatch_retain(myExistingQueue);
1067   - * return myExistingQueue;
1068   -**/
1069   -- (nullable dispatch_queue_t)newSocketQueueForConnectionFromAddress:(NSData *)address onSocket:(GCDAsyncSocket *)sock;
1070   -
1071   -/**
1072   - * Called when a socket accepts a connection.
1073   - * Another socket is automatically spawned to handle it.
1074   - *
1075   - * You must retain the newSocket if you wish to handle the connection.
1076   - * Otherwise the newSocket instance will be released and the spawned connection will be closed.
1077   - *
1078   - * By default the new socket will have the same delegate and delegateQueue.
1079   - * You may, of course, change this at any time.
1080   -**/
1081   -- (void)socket:(GCDAsyncSocket *)sock didAcceptNewSocket:(GCDAsyncSocket *)newSocket;
1082   -
1083   -/**
1084   - * Called when a socket connects and is ready for reading and writing.
1085   - * The host parameter will be an IP address, not a DNS name.
1086   -**/
1087   -- (void)socket:(GCDAsyncSocket *)sock didConnectToHost:(NSString *)host port:(uint16_t)port;
1088   -
1089   -/**
1090   - * Called when a socket connects and is ready for reading and writing.
1091   - * The host parameter will be an IP address, not a DNS name.
1092   - **/
1093   -- (void)socket:(GCDAsyncSocket *)sock didConnectToUrl:(NSURL *)url;
1094   -
1095   -/**
1096   - * Called when a socket has completed reading the requested data into memory.
1097   - * Not called if there is an error.
1098   -**/
1099   -- (void)socket:(GCDAsyncSocket *)sock didReadData:(NSData *)data withTag:(long)tag;
1100   -
1101   -/**
1102   - * Called when a socket has read in data, but has not yet completed the read.
1103   - * This would occur if using readToData: or readToLength: methods.
1104   - * It may be used to for things such as updating progress bars.
1105   -**/
1106   -- (void)socket:(GCDAsyncSocket *)sock didReadPartialDataOfLength:(NSUInteger)partialLength tag:(long)tag;
1107   -
1108   -/**
1109   - * Called when a socket has completed writing the requested data. Not called if there is an error.
1110   -**/
1111   -- (void)socket:(GCDAsyncSocket *)sock didWriteDataWithTag:(long)tag;
1112   -
1113   -/**
1114   - * Called when a socket has written some data, but has not yet completed the entire write.
1115   - * It may be used to for things such as updating progress bars.
1116   -**/
1117   -- (void)socket:(GCDAsyncSocket *)sock didWritePartialDataOfLength:(NSUInteger)partialLength tag:(long)tag;
1118   -
1119   -/**
1120   - * Called if a read operation has reached its timeout without completing.
1121   - * This method allows you to optionally extend the timeout.
1122   - * If you return a positive time interval (> 0) the read's timeout will be extended by the given amount.
1123   - * If you don't implement this method, or return a non-positive time interval (<= 0) the read will timeout as usual.
1124   - *
1125   - * The elapsed parameter is the sum of the original timeout, plus any additions previously added via this method.
1126   - * The length parameter is the number of bytes that have been read so far for the read operation.
1127   - *
1128   - * Note that this method may be called multiple times for a single read if you return positive numbers.
1129   -**/
1130   -- (NSTimeInterval)socket:(GCDAsyncSocket *)sock shouldTimeoutReadWithTag:(long)tag
1131   - elapsed:(NSTimeInterval)elapsed
1132   - bytesDone:(NSUInteger)length;
1133   -
1134   -/**
1135   - * Called if a write operation has reached its timeout without completing.
1136   - * This method allows you to optionally extend the timeout.
1137   - * If you return a positive time interval (> 0) the write's timeout will be extended by the given amount.
1138   - * If you don't implement this method, or return a non-positive time interval (<= 0) the write will timeout as usual.
1139   - *
1140   - * The elapsed parameter is the sum of the original timeout, plus any additions previously added via this method.
1141   - * The length parameter is the number of bytes that have been written so far for the write operation.
1142   - *
1143   - * Note that this method may be called multiple times for a single write if you return positive numbers.
1144   -**/
1145   -- (NSTimeInterval)socket:(GCDAsyncSocket *)sock shouldTimeoutWriteWithTag:(long)tag
1146   - elapsed:(NSTimeInterval)elapsed
1147   - bytesDone:(NSUInteger)length;
1148   -
1149   -/**
1150   - * Conditionally called if the read stream closes, but the write stream may still be writeable.
1151   - *
1152   - * This delegate method is only called if autoDisconnectOnClosedReadStream has been set to NO.
1153   - * See the discussion on the autoDisconnectOnClosedReadStream method for more information.
1154   -**/
1155   -- (void)socketDidCloseReadStream:(GCDAsyncSocket *)sock;
1156   -
1157   -/**
1158   - * Called when a socket disconnects with or without error.
1159   - *
1160   - * If you call the disconnect method, and the socket wasn't already disconnected,
1161   - * then an invocation of this delegate method will be enqueued on the delegateQueue
1162   - * before the disconnect method returns.
1163   - *
1164   - * Note: If the GCDAsyncSocket instance is deallocated while it is still connected,
1165   - * and the delegate is not also deallocated, then this method will be invoked,
1166   - * but the sock parameter will be nil. (It must necessarily be nil since it is no longer available.)
1167   - * This is a generally rare, but is possible if one writes code like this:
1168   - *
1169   - * asyncSocket = nil; // I'm implicitly disconnecting the socket
1170   - *
1171   - * In this case it may preferrable to nil the delegate beforehand, like this:
1172   - *
1173   - * asyncSocket.delegate = nil; // Don't invoke my delegate method
1174   - * asyncSocket = nil; // I'm implicitly disconnecting the socket
1175   - *
1176   - * Of course, this depends on how your state machine is configured.
1177   -**/
1178   -- (void)socketDidDisconnect:(GCDAsyncSocket *)sock withError:(nullable NSError *)err;
1179   -
1180   -/**
1181   - * Called after the socket has successfully completed SSL/TLS negotiation.
1182   - * This method is not called unless you use the provided startTLS method.
1183   - *
1184   - * If a SSL/TLS negotiation fails (invalid certificate, etc) then the socket will immediately close,
1185   - * and the socketDidDisconnect:withError: delegate method will be called with the specific SSL error code.
1186   -**/
1187   -- (void)socketDidSecure:(GCDAsyncSocket *)sock;
1188   -
1189   -/**
1190   - * Allows a socket delegate to hook into the TLS handshake and manually validate the peer it's connecting to.
1191   - *
1192   - * This is only called if startTLS is invoked with options that include:
1193   - * - GCDAsyncSocketManuallyEvaluateTrust == YES
1194   - *
1195   - * Typically the delegate will use SecTrustEvaluate (and related functions) to properly validate the peer.
1196   - *
1197   - * Note from Apple's documentation:
1198   - * Because [SecTrustEvaluate] might look on the network for certificates in the certificate chain,
1199   - * [it] might block while attempting network access. You should never call it from your main thread;
1200   - * call it only from within a function running on a dispatch queue or on a separate thread.
1201   - *
1202   - * Thus this method uses a completionHandler block rather than a normal return value.
1203   - * The completionHandler block is thread-safe, and may be invoked from a background queue/thread.
1204   - * It is safe to invoke the completionHandler block even if the socket has been closed.
1205   -**/
1206   -- (void)socket:(GCDAsyncSocket *)sock didReceiveTrust:(SecTrustRef)trust
1207   - completionHandler:(void (^)(BOOL shouldTrustPeer))completionHandler;
1208   -
1209   -@end
1210   -NS_ASSUME_NONNULL_END
CNLiveXMPPManagerDemo/CocoaAsyncSocket.framework/Headers/GCDAsyncUdpSocket.h deleted 100644 → 0
  View file @b6c7dfc
1   -//
2   -// GCDAsyncUdpSocket
3   -//
4   -// This class is in the public domain.
5   -// Originally created by Robbie Hanson of Deusty LLC.
6   -// Updated and maintained by Deusty LLC and the Apple development community.
7   -//
8   -// https://github.com/robbiehanson/CocoaAsyncSocket
9   -//
10   -
11   -#import <Foundation/Foundation.h>
12   -#import <dispatch/dispatch.h>
13   -#import <TargetConditionals.h>
14   -#import <Availability.h>
15   -
16   -NS_ASSUME_NONNULL_BEGIN
17   -extern NSString *const GCDAsyncUdpSocketException;
18   -extern NSString *const GCDAsyncUdpSocketErrorDomain;
19   -
20   -extern NSString *const GCDAsyncUdpSocketQueueName;
21   -extern NSString *const GCDAsyncUdpSocketThreadName;
22   -
23   -typedef NS_ENUM(NSInteger, GCDAsyncUdpSocketError) {
24   - GCDAsyncUdpSocketNoError = 0, // Never used
25   - GCDAsyncUdpSocketBadConfigError, // Invalid configuration
26   - GCDAsyncUdpSocketBadParamError, // Invalid parameter was passed
27   - GCDAsyncUdpSocketSendTimeoutError, // A send operation timed out
28   - GCDAsyncUdpSocketClosedError, // The socket was closed
29   - GCDAsyncUdpSocketOtherError, // Description provided in userInfo
30   -};
31   -
32   -////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
33   -#pragma mark -
34   -////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
35   -
36   -@class GCDAsyncUdpSocket;
37   -
38   -@protocol GCDAsyncUdpSocketDelegate
39   -@optional
40   -
41   -/**
42   - * By design, UDP is a connectionless protocol, and connecting is not needed.
43   - * However, you may optionally choose to connect to a particular host for reasons
44   - * outlined in the documentation for the various connect methods listed above.
45   - *
46   - * This method is called if one of the connect methods are invoked, and the connection is successful.
47   -**/
48   -- (void)udpSocket:(GCDAsyncUdpSocket *)sock didConnectToAddress:(NSData *)address;
49   -
50   -/**
51   - * By design, UDP is a connectionless protocol, and connecting is not needed.
52   - * However, you may optionally choose to connect to a particular host for reasons
53   - * outlined in the documentation for the various connect methods listed above.
54   - *
55   - * This method is called if one of the connect methods are invoked, and the connection fails.
56   - * This may happen, for example, if a domain name is given for the host and the domain name is unable to be resolved.
57   -**/
58   -- (void)udpSocket:(GCDAsyncUdpSocket *)sock didNotConnect:(NSError *)error;
59   -
60   -/**
61   - * Called when the datagram with the given tag has been sent.
62   -**/
63   -- (void)udpSocket:(GCDAsyncUdpSocket *)sock didSendDataWithTag:(long)tag;
64   -
65   -/**
66   - * Called if an error occurs while trying to send a datagram.
67   - * This could be due to a timeout, or something more serious such as the data being too large to fit in a sigle packet.
68   -**/
69   -- (void)udpSocket:(GCDAsyncUdpSocket *)sock didNotSendDataWithTag:(long)tag dueToError:(NSError *)error;
70   -
71   -/**
72   - * Called when the socket has received the requested datagram.
73   -**/
74   -- (void)udpSocket:(GCDAsyncUdpSocket *)sock didReceiveData:(NSData *)data
75   - fromAddress:(NSData *)address
76   - withFilterContext:(nullable id)filterContext;
77   -
78   -/**
79   - * Called when the socket is closed.
80   -**/
81   -- (void)udpSocketDidClose:(GCDAsyncUdpSocket *)sock withError:(NSError *)error;
82   -
83   -@end
84   -
85   -/**
86   - * You may optionally set a receive filter for the socket.
87   - * A filter can provide several useful features:
88   - *
89   - * 1. Many times udp packets need to be parsed.
90   - * Since the filter can run in its own independent queue, you can parallelize this parsing quite easily.
91   - * The end result is a parallel socket io, datagram parsing, and packet processing.
92   - *
93   - * 2. Many times udp packets are discarded because they are duplicate/unneeded/unsolicited.
94   - * The filter can prevent such packets from arriving at the delegate.
95   - * And because the filter can run in its own independent queue, this doesn't slow down the delegate.
96   - *
97   - * - Since the udp protocol does not guarantee delivery, udp packets may be lost.
98   - * Many protocols built atop udp thus provide various resend/re-request algorithms.
99   - * This sometimes results in duplicate packets arriving.
100   - * A filter may allow you to architect the duplicate detection code to run in parallel to normal processing.
101   - *
102   - * - Since the udp socket may be connectionless, its possible for unsolicited packets to arrive.
103   - * Such packets need to be ignored.
104   - *
105   - * 3. Sometimes traffic shapers are needed to simulate real world environments.
106   - * A filter allows you to write custom code to simulate such environments.
107   - * The ability to code this yourself is especially helpful when your simulated environment
108   - * is more complicated than simple traffic shaping (e.g. simulating a cone port restricted router),
109   - * or the system tools to handle this aren't available (e.g. on a mobile device).
110   - *
111   - * @param data - The packet that was received.
112   - * @param address - The address the data was received from.
113   - * See utilities section for methods to extract info from address.
114   - * @param context - Out parameter you may optionally set, which will then be passed to the delegate method.
115   - * For example, filter block can parse the data and then,
116   - * pass the parsed data to the delegate.
117   - *
118   - * @returns - YES if the received packet should be passed onto the delegate.
119   - * NO if the received packet should be discarded, and not reported to the delegete.
120   - *
121   - * Example:
122   - *
123   - * GCDAsyncUdpSocketReceiveFilterBlock filter = ^BOOL (NSData *data, NSData *address, id *context) {
124   - *
125   - * MyProtocolMessage *msg = [MyProtocol parseMessage:data];
126   - *
127   - * *context = response;
128   - * return (response != nil);
129   - * };
130   - * [udpSocket setReceiveFilter:filter withQueue:myParsingQueue];
131   - *
132   -**/
133   -typedef BOOL (^GCDAsyncUdpSocketReceiveFilterBlock)(NSData *data, NSData *address, id __nullable * __nonnull context);
134   -
135   -/**
136   - * You may optionally set a send filter for the socket.
137   - * A filter can provide several interesting possibilities:
138   - *
139   - * 1. Optional caching of resolved addresses for domain names.
140   - * The cache could later be consulted, resulting in fewer system calls to getaddrinfo.
141   - *
142   - * 2. Reusable modules of code for bandwidth monitoring.
143   - *
144   - * 3. Sometimes traffic shapers are needed to simulate real world environments.
145   - * A filter allows you to write custom code to simulate such environments.
146   - * The ability to code this yourself is especially helpful when your simulated environment
147   - * is more complicated than simple traffic shaping (e.g. simulating a cone port restricted router),
148   - * or the system tools to handle this aren't available (e.g. on a mobile device).
149   - *
150   - * @param data - The packet that was received.
151   - * @param address - The address the data was received from.
152   - * See utilities section for methods to extract info from address.
153   - * @param tag - The tag that was passed in the send method.
154   - *
155   - * @returns - YES if the packet should actually be sent over the socket.
156   - * NO if the packet should be silently dropped (not sent over the socket).
157   - *
158   - * Regardless of the return value, the delegate will be informed that the packet was successfully sent.
159   - *
160   -**/
161   -typedef BOOL (^GCDAsyncUdpSocketSendFilterBlock)(NSData *data, NSData *address, long tag);
162   -
163   -
164   -@interface GCDAsyncUdpSocket : NSObject
165   -
166   -/**
167   - * GCDAsyncUdpSocket uses the standard delegate paradigm,
168   - * but executes all delegate callbacks on a given delegate dispatch queue.
169   - * This allows for maximum concurrency, while at the same time providing easy thread safety.
170   - *
171   - * You MUST set a delegate AND delegate dispatch queue before attempting to
172   - * use the socket, or you will get an error.
173   - *
174   - * The socket queue is optional.
175   - * If you pass NULL, GCDAsyncSocket will automatically create its own socket queue.
176   - * If you choose to provide a socket queue, the socket queue must not be a concurrent queue,
177   - * then please see the discussion for the method markSocketQueueTargetQueue.
178   - *
179   - * The delegate queue and socket queue can optionally be the same.
180   -**/
181   -- (instancetype)init;
182   -- (instancetype)initWithSocketQueue:(nullable dispatch_queue_t)sq;
183   -- (instancetype)initWithDelegate:(nullable id <GCDAsyncUdpSocketDelegate>)aDelegate delegateQueue:(nullable dispatch_queue_t)dq;
184   -- (instancetype)initWithDelegate:(nullable id <GCDAsyncUdpSocketDelegate>)aDelegate delegateQueue:(nullable dispatch_queue_t)dq socketQueue:(nullable dispatch_queue_t)sq;
185   -
186   -#pragma mark Configuration
187   -
188   -- (nullable id <GCDAsyncUdpSocketDelegate>)delegate;
189   -- (void)setDelegate:(nullable id <GCDAsyncUdpSocketDelegate>)delegate;
190   -- (void)synchronouslySetDelegate:(nullable id <GCDAsyncUdpSocketDelegate>)delegate;
191   -
192   -- (nullable dispatch_queue_t)delegateQueue;
193   -- (void)setDelegateQueue:(nullable dispatch_queue_t)delegateQueue;
194   -- (void)synchronouslySetDelegateQueue:(nullable dispatch_queue_t)delegateQueue;
195   -
196   -- (void)getDelegate:(id <GCDAsyncUdpSocketDelegate> __nullable * __nullable)delegatePtr delegateQueue:(dispatch_queue_t __nullable * __nullable)delegateQueuePtr;
197   -- (void)setDelegate:(nullable id <GCDAsyncUdpSocketDelegate>)delegate delegateQueue:(nullable dispatch_queue_t)delegateQueue;
198   -- (void)synchronouslySetDelegate:(nullable id <GCDAsyncUdpSocketDelegate>)delegate delegateQueue:(nullable dispatch_queue_t)delegateQueue;
199   -
200   -/**
201   - * By default, both IPv4 and IPv6 are enabled.
202   - *
203   - * This means GCDAsyncUdpSocket automatically supports both protocols,
204   - * and can send to IPv4 or IPv6 addresses,
205   - * as well as receive over IPv4 and IPv6.
206   - *
207   - * For operations that require DNS resolution, GCDAsyncUdpSocket supports both IPv4 and IPv6.
208   - * If a DNS lookup returns only IPv4 results, GCDAsyncUdpSocket will automatically use IPv4.
209   - * If a DNS lookup returns only IPv6 results, GCDAsyncUdpSocket will automatically use IPv6.
210   - * If a DNS lookup returns both IPv4 and IPv6 results, then the protocol used depends on the configured preference.
211   - * If IPv4 is preferred, then IPv4 is used.
212   - * If IPv6 is preferred, then IPv6 is used.
213   - * If neutral, then the first IP version in the resolved array will be used.
214   - *
215   - * Starting with Mac OS X 10.7 Lion and iOS 5, the default IP preference is neutral.
216   - * On prior systems the default IP preference is IPv4.
217   - **/
218   -- (BOOL)isIPv4Enabled;
219   -- (void)setIPv4Enabled:(BOOL)flag;
220   -
221   -- (BOOL)isIPv6Enabled;
222   -- (void)setIPv6Enabled:(BOOL)flag;
223   -
224   -- (BOOL)isIPv4Preferred;
225   -- (BOOL)isIPv6Preferred;
226   -- (BOOL)isIPVersionNeutral;
227   -
228   -- (void)setPreferIPv4;
229   -- (void)setPreferIPv6;
230   -- (void)setIPVersionNeutral;
231   -
232   -/**
233   - * Gets/Sets the maximum size of the buffer that will be allocated for receive operations.
234   - * The default maximum size is 9216 bytes.
235   - *
236   - * The theoretical maximum size of any IPv4 UDP packet is UINT16_MAX = 65535.
237   - * The theoretical maximum size of any IPv6 UDP packet is UINT32_MAX = 4294967295.
238   - *
239   - * Since the OS/GCD notifies us of the size of each received UDP packet,
240   - * the actual allocated buffer size for each packet is exact.
241   - * And in practice the size of UDP packets is generally much smaller than the max.
242   - * Indeed most protocols will send and receive packets of only a few bytes,
243   - * or will set a limit on the size of packets to prevent fragmentation in the IP layer.
244   - *
245   - * If you set the buffer size too small, the sockets API in the OS will silently discard
246   - * any extra data, and you will not be notified of the error.
247   -**/
248   -- (uint16_t)maxReceiveIPv4BufferSize;
249   -- (void)setMaxReceiveIPv4BufferSize:(uint16_t)max;
250   -
251   -- (uint32_t)maxReceiveIPv6BufferSize;
252   -- (void)setMaxReceiveIPv6BufferSize:(uint32_t)max;
253   -
254   -/**
255   - * User data allows you to associate arbitrary information with the socket.
256   - * This data is not used internally in any way.
257   -**/
258   -- (nullable id)userData;
259   -- (void)setUserData:(nullable id)arbitraryUserData;
260   -
261   -#pragma mark Diagnostics
262   -
263   -/**
264   - * Returns the local address info for the socket.
265   - *
266   - * The localAddress method returns a sockaddr structure wrapped in a NSData object.
267   - * The localHost method returns the human readable IP address as a string.
268   - *
269   - * Note: Address info may not be available until after the socket has been binded, connected
270   - * or until after data has been sent.
271   -**/
272   -- (nullable NSData *)localAddress;
273   -- (nullable NSString *)localHost;
274   -- (uint16_t)localPort;
275   -
276   -- (nullable NSData *)localAddress_IPv4;
277   -- (nullable NSString *)localHost_IPv4;
278   -- (uint16_t)localPort_IPv4;
279   -
280   -- (nullable NSData *)localAddress_IPv6;
281   -- (nullable NSString *)localHost_IPv6;
282   -- (uint16_t)localPort_IPv6;
283   -
284   -/**
285   - * Returns the remote address info for the socket.
286   - *
287   - * The connectedAddress method returns a sockaddr structure wrapped in a NSData object.
288   - * The connectedHost method returns the human readable IP address as a string.
289   - *
290   - * Note: Since UDP is connectionless by design, connected address info
291   - * will not be available unless the socket is explicitly connected to a remote host/port.
292   - * If the socket is not connected, these methods will return nil / 0.
293   -**/
294   -- (nullable NSData *)connectedAddress;
295   -- (nullable NSString *)connectedHost;
296   -- (uint16_t)connectedPort;
297   -
298   -/**
299   - * Returns whether or not this socket has been connected to a single host.
300   - * By design, UDP is a connectionless protocol, and connecting is not needed.
301   - * If connected, the socket will only be able to send/receive data to/from the connected host.
302   -**/
303   -- (BOOL)isConnected;
304   -
305   -/**
306   - * Returns whether or not this socket has been closed.
307   - * The only way a socket can be closed is if you explicitly call one of the close methods.
308   -**/
309   -- (BOOL)isClosed;
310   -
311   -/**
312   - * Returns whether or not this socket is IPv4.
313   - *
314   - * By default this will be true, unless:
315   - * - IPv4 is disabled (via setIPv4Enabled:)
316   - * - The socket is explicitly bound to an IPv6 address
317   - * - The socket is connected to an IPv6 address
318   -**/
319   -- (BOOL)isIPv4;
320   -
321   -/**
322   - * Returns whether or not this socket is IPv6.
323   - *
324   - * By default this will be true, unless:
325   - * - IPv6 is disabled (via setIPv6Enabled:)
326   - * - The socket is explicitly bound to an IPv4 address
327   - * _ The socket is connected to an IPv4 address
328   - *
329   - * This method will also return false on platforms that do not support IPv6.
330   - * Note: The iPhone does not currently support IPv6.
331   -**/
332   -- (BOOL)isIPv6;
333   -
334   -#pragma mark Binding
335   -
336   -/**
337   - * Binds the UDP socket to the given port.
338   - * Binding should be done for server sockets that receive data prior to sending it.
339   - * Client sockets can skip binding,
340   - * as the OS will automatically assign the socket an available port when it starts sending data.
341   - *
342   - * You may optionally pass a port number of zero to immediately bind the socket,
343   - * yet still allow the OS to automatically assign an available port.
344   - *
345   - * You cannot bind a socket after its been connected.
346   - * You can only bind a socket once.
347   - * You can still connect a socket (if desired) after binding.
348   - *
349   - * On success, returns YES.
350   - * Otherwise returns NO, and sets errPtr. If you don't care about the error, you can pass NULL for errPtr.
351   -**/
352   -- (BOOL)bindToPort:(uint16_t)port error:(NSError **)errPtr;
353   -
354   -/**
355   - * Binds the UDP socket to the given port and optional interface.
356   - * Binding should be done for server sockets that receive data prior to sending it.
357   - * Client sockets can skip binding,
358   - * as the OS will automatically assign the socket an available port when it starts sending data.
359   - *
360   - * You may optionally pass a port number of zero to immediately bind the socket,
361   - * yet still allow the OS to automatically assign an available port.
362   - *
363   - * The interface may be a name (e.g. "en1" or "lo0") or the corresponding IP address (e.g. "192.168.4.35").
364   - * You may also use the special strings "localhost" or "loopback" to specify that
365   - * the socket only accept packets from the local machine.
366   - *
367   - * You cannot bind a socket after its been connected.
368   - * You can only bind a socket once.
369   - * You can still connect a socket (if desired) after binding.
370   - *
371   - * On success, returns YES.
372   - * Otherwise returns NO, and sets errPtr. If you don't care about the error, you can pass NULL for errPtr.
373   -**/
374   -- (BOOL)bindToPort:(uint16_t)port interface:(nullable NSString *)interface error:(NSError **)errPtr;
375   -
376   -/**
377   - * Binds the UDP socket to the given address, specified as a sockaddr structure wrapped in a NSData object.
378   - *
379   - * If you have an existing struct sockaddr you can convert it to a NSData object like so:
380   - * struct sockaddr sa -> NSData *dsa = [NSData dataWithBytes:&remoteAddr length:remoteAddr.sa_len];
381   - * struct sockaddr *sa -> NSData *dsa = [NSData dataWithBytes:remoteAddr length:remoteAddr->sa_len];
382   - *
383   - * Binding should be done for server sockets that receive data prior to sending it.
384   - * Client sockets can skip binding,
385   - * as the OS will automatically assign the socket an available port when it starts sending data.
386   - *
387   - * You cannot bind a socket after its been connected.
388   - * You can only bind a socket once.
389   - * You can still connect a socket (if desired) after binding.
390   - *
391   - * On success, returns YES.
392   - * Otherwise returns NO, and sets errPtr. If you don't care about the error, you can pass NULL for errPtr.
393   -**/
394   -- (BOOL)bindToAddress:(NSData *)localAddr error:(NSError **)errPtr;
395   -
396   -#pragma mark Connecting
397   -
398   -/**
399   - * Connects the UDP socket to the given host and port.
400   - * By design, UDP is a connectionless protocol, and connecting is not needed.
401   - *
402   - * Choosing to connect to a specific host/port has the following effect:
403   - * - You will only be able to send data to the connected host/port.
404   - * - You will only be able to receive data from the connected host/port.
405   - * - You will receive ICMP messages that come from the connected host/port, such as "connection refused".
406   - *
407   - * The actual process of connecting a UDP socket does not result in any communication on the socket.
408   - * It simply changes the internal state of the socket.
409   - *
410   - * You cannot bind a socket after it has been connected.
411   - * You can only connect a socket once.
412   - *
413   - * The host may be a domain name (e.g. "deusty.com") or an IP address string (e.g. "192.168.0.2").
414   - *
415   - * This method is asynchronous as it requires a DNS lookup to resolve the given host name.
416   - * If an obvious error is detected, this method immediately returns NO and sets errPtr.
417   - * If you don't care about the error, you can pass nil for errPtr.
418   - * Otherwise, this method returns YES and begins the asynchronous connection process.
419   - * The result of the asynchronous connection process will be reported via the delegate methods.
420   - **/
421   -- (BOOL)connectToHost:(NSString *)host onPort:(uint16_t)port error:(NSError **)errPtr;
422   -
423   -/**
424   - * Connects the UDP socket to the given address, specified as a sockaddr structure wrapped in a NSData object.
425   - *
426   - * If you have an existing struct sockaddr you can convert it to a NSData object like so:
427   - * struct sockaddr sa -> NSData *dsa = [NSData dataWithBytes:&remoteAddr length:remoteAddr.sa_len];
428   - * struct sockaddr *sa -> NSData *dsa = [NSData dataWithBytes:remoteAddr length:remoteAddr->sa_len];
429   - *
430   - * By design, UDP is a connectionless protocol, and connecting is not needed.
431   - *
432   - * Choosing to connect to a specific address has the following effect:
433   - * - You will only be able to send data to the connected address.
434   - * - You will only be able to receive data from the connected address.
435   - * - You will receive ICMP messages that come from the connected address, such as "connection refused".
436   - *
437   - * Connecting a UDP socket does not result in any communication on the socket.
438   - * It simply changes the internal state of the socket.
439   - *
440   - * You cannot bind a socket after its been connected.
441   - * You can only connect a socket once.
442   - *
443   - * On success, returns YES.
444   - * Otherwise returns NO, and sets errPtr. If you don't care about the error, you can pass nil for errPtr.
445   - *
446   - * Note: Unlike the connectToHost:onPort:error: method, this method does not require a DNS lookup.
447   - * Thus when this method returns, the connection has either failed or fully completed.
448   - * In other words, this method is synchronous, unlike the asynchronous connectToHost::: method.
449   - * However, for compatibility and simplification of delegate code, if this method returns YES
450   - * then the corresponding delegate method (udpSocket:didConnectToHost:port:) is still invoked.
451   -**/
452   -- (BOOL)connectToAddress:(NSData *)remoteAddr error:(NSError **)errPtr;
453   -
454   -#pragma mark Multicast
455   -
456   -/**
457   - * Join multicast group.
458   - * Group should be an IP address (eg @"225.228.0.1").
459   - *
460   - * On success, returns YES.
461   - * Otherwise returns NO, and sets errPtr. If you don't care about the error, you can pass nil for errPtr.
462   -**/
463   -- (BOOL)joinMulticastGroup:(NSString *)group error:(NSError **)errPtr;
464   -
465   -/**
466   - * Join multicast group.
467   - * Group should be an IP address (eg @"225.228.0.1").
468   - * The interface may be a name (e.g. "en1" or "lo0") or the corresponding IP address (e.g. "192.168.4.35").
469   - *
470   - * On success, returns YES.
471   - * Otherwise returns NO, and sets errPtr. If you don't care about the error, you can pass nil for errPtr.
472   -**/
473   -- (BOOL)joinMulticastGroup:(NSString *)group onInterface:(nullable NSString *)interface error:(NSError **)errPtr;
474   -
475   -- (BOOL)leaveMulticastGroup:(NSString *)group error:(NSError **)errPtr;
476   -- (BOOL)leaveMulticastGroup:(NSString *)group onInterface:(nullable NSString *)interface error:(NSError **)errPtr;
477   -
478   -#pragma mark Reuse Port
479   -
480   -/**
481   - * By default, only one socket can be bound to a given IP address + port at a time.
482   - * To enable multiple processes to simultaneously bind to the same address+port,
483   - * you need to enable this functionality in the socket. All processes that wish to
484   - * use the address+port simultaneously must all enable reuse port on the socket
485   - * bound to that port.
486   - **/
487   -- (BOOL)enableReusePort:(BOOL)flag error:(NSError **)errPtr;
488   -
489   -#pragma mark Broadcast
490   -
491   -/**
492   - * By default, the underlying socket in the OS will not allow you to send broadcast messages.
493   - * In order to send broadcast messages, you need to enable this functionality in the socket.
494   - *
495   - * A broadcast is a UDP message to addresses like "192.168.255.255" or "255.255.255.255" that is
496   - * delivered to every host on the network.
497   - * The reason this is generally disabled by default (by the OS) is to prevent
498   - * accidental broadcast messages from flooding the network.
499   -**/
500   -- (BOOL)enableBroadcast:(BOOL)flag error:(NSError **)errPtr;
501   -
502   -#pragma mark Sending
503   -
504   -/**
505   - * Asynchronously sends the given data, with the given timeout and tag.
506   - *
507   - * This method may only be used with a connected socket.
508   - * Recall that connecting is optional for a UDP socket.
509   - * For connected sockets, data can only be sent to the connected address.
510   - * For non-connected sockets, the remote destination is specified for each packet.
511   - * For more information about optionally connecting udp sockets, see the documentation for the connect methods above.
512   - *
513   - * @param data
514   - * The data to send.
515   - * If data is nil or zero-length, this method does nothing.
516   - * If passing NSMutableData, please read the thread-safety notice below.
517   - *
518   - * @param timeout
519   - * The timeout for the send opeartion.
520   - * If the timeout value is negative, the send operation will not use a timeout.
521   - *
522   - * @param tag
523   - * The tag is for your convenience.
524   - * It is not sent or received over the socket in any manner what-so-ever.
525   - * It is reported back as a parameter in the udpSocket:didSendDataWithTag:
526   - * or udpSocket:didNotSendDataWithTag:dueToError: methods.
527   - * You can use it as an array index, state id, type constant, etc.
528   - *
529   - *
530   - * Thread-Safety Note:
531   - * If the given data parameter is mutable (NSMutableData) then you MUST NOT alter the data while
532   - * the socket is sending it. In other words, it's not safe to alter the data until after the delegate method
533   - * udpSocket:didSendDataWithTag: or udpSocket:didNotSendDataWithTag:dueToError: is invoked signifying
534   - * that this particular send operation has completed.
535   - * This is due to the fact that GCDAsyncUdpSocket does NOT copy the data.
536   - * It simply retains it for performance reasons.
537   - * Often times, if NSMutableData is passed, it is because a request/response was built up in memory.
538   - * Copying this data adds an unwanted/unneeded overhead.
539   - * If you need to write data from an immutable buffer, and you need to alter the buffer before the socket
540   - * completes sending the bytes (which is NOT immediately after this method returns, but rather at a later time
541   - * when the delegate method notifies you), then you should first copy the bytes, and pass the copy to this method.
542   -**/
543   -- (void)sendData:(NSData *)data withTimeout:(NSTimeInterval)timeout tag:(long)tag;
544   -
545   -/**
546   - * Asynchronously sends the given data, with the given timeout and tag, to the given host and port.
547   - *
548   - * This method cannot be used with a connected socket.
549   - * Recall that connecting is optional for a UDP socket.
550   - * For connected sockets, data can only be sent to the connected address.
551   - * For non-connected sockets, the remote destination is specified for each packet.
552   - * For more information about optionally connecting udp sockets, see the documentation for the connect methods above.
553   - *
554   - * @param data
555   - * The data to send.
556   - * If data is nil or zero-length, this method does nothing.
557   - * If passing NSMutableData, please read the thread-safety notice below.
558   - *
559   - * @param host
560   - * The destination to send the udp packet to.
561   - * May be specified as a domain name (e.g. "deusty.com") or an IP address string (e.g. "192.168.0.2").
562   - * You may also use the convenience strings of "loopback" or "localhost".
563   - *
564   - * @param port
565   - * The port of the host to send to.
566   - *
567   - * @param timeout
568   - * The timeout for the send opeartion.
569   - * If the timeout value is negative, the send operation will not use a timeout.
570   - *
571   - * @param tag
572   - * The tag is for your convenience.
573   - * It is not sent or received over the socket in any manner what-so-ever.
574   - * It is reported back as a parameter in the udpSocket:didSendDataWithTag:
575   - * or udpSocket:didNotSendDataWithTag:dueToError: methods.
576   - * You can use it as an array index, state id, type constant, etc.
577   - *
578   - *
579   - * Thread-Safety Note:
580   - * If the given data parameter is mutable (NSMutableData) then you MUST NOT alter the data while
581   - * the socket is sending it. In other words, it's not safe to alter the data until after the delegate method
582   - * udpSocket:didSendDataWithTag: or udpSocket:didNotSendDataWithTag:dueToError: is invoked signifying
583   - * that this particular send operation has completed.
584   - * This is due to the fact that GCDAsyncUdpSocket does NOT copy the data.
585   - * It simply retains it for performance reasons.
586   - * Often times, if NSMutableData is passed, it is because a request/response was built up in memory.
587   - * Copying this data adds an unwanted/unneeded overhead.
588   - * If you need to write data from an immutable buffer, and you need to alter the buffer before the socket
589   - * completes sending the bytes (which is NOT immediately after this method returns, but rather at a later time
590   - * when the delegate method notifies you), then you should first copy the bytes, and pass the copy to this method.
591   -**/
592   -- (void)sendData:(NSData *)data
593   - toHost:(NSString *)host
594   - port:(uint16_t)port
595   - withTimeout:(NSTimeInterval)timeout
596   - tag:(long)tag;
597   -
598   -/**
599   - * Asynchronously sends the given data, with the given timeout and tag, to the given address.
600   - *
601   - * This method cannot be used with a connected socket.
602   - * Recall that connecting is optional for a UDP socket.
603   - * For connected sockets, data can only be sent to the connected address.
604   - * For non-connected sockets, the remote destination is specified for each packet.
605   - * For more information about optionally connecting udp sockets, see the documentation for the connect methods above.
606   - *
607   - * @param data
608   - * The data to send.
609   - * If data is nil or zero-length, this method does nothing.
610   - * If passing NSMutableData, please read the thread-safety notice below.
611   - *
612   - * @param remoteAddr
613   - * The address to send the data to (specified as a sockaddr structure wrapped in a NSData object).
614   - *
615   - * @param timeout
616   - * The timeout for the send opeartion.
617   - * If the timeout value is negative, the send operation will not use a timeout.
618   - *
619   - * @param tag
620   - * The tag is for your convenience.
621   - * It is not sent or received over the socket in any manner what-so-ever.
622   - * It is reported back as a parameter in the udpSocket:didSendDataWithTag:
623   - * or udpSocket:didNotSendDataWithTag:dueToError: methods.
624   - * You can use it as an array index, state id, type constant, etc.
625   - *
626   - *
627   - * Thread-Safety Note:
628   - * If the given data parameter is mutable (NSMutableData) then you MUST NOT alter the data while
629   - * the socket is sending it. In other words, it's not safe to alter the data until after the delegate method
630   - * udpSocket:didSendDataWithTag: or udpSocket:didNotSendDataWithTag:dueToError: is invoked signifying
631   - * that this particular send operation has completed.
632   - * This is due to the fact that GCDAsyncUdpSocket does NOT copy the data.
633   - * It simply retains it for performance reasons.
634   - * Often times, if NSMutableData is passed, it is because a request/response was built up in memory.
635   - * Copying this data adds an unwanted/unneeded overhead.
636   - * If you need to write data from an immutable buffer, and you need to alter the buffer before the socket
637   - * completes sending the bytes (which is NOT immediately after this method returns, but rather at a later time
638   - * when the delegate method notifies you), then you should first copy the bytes, and pass the copy to this method.
639   -**/
640   -- (void)sendData:(NSData *)data toAddress:(NSData *)remoteAddr withTimeout:(NSTimeInterval)timeout tag:(long)tag;
641   -
642   -/**
643   - * You may optionally set a send filter for the socket.
644   - * A filter can provide several interesting possibilities:
645   - *
646   - * 1. Optional caching of resolved addresses for domain names.
647   - * The cache could later be consulted, resulting in fewer system calls to getaddrinfo.
648   - *
649   - * 2. Reusable modules of code for bandwidth monitoring.
650   - *
651   - * 3. Sometimes traffic shapers are needed to simulate real world environments.
652   - * A filter allows you to write custom code to simulate such environments.
653   - * The ability to code this yourself is especially helpful when your simulated environment
654   - * is more complicated than simple traffic shaping (e.g. simulating a cone port restricted router),
655   - * or the system tools to handle this aren't available (e.g. on a mobile device).
656   - *
657   - * For more information about GCDAsyncUdpSocketSendFilterBlock, see the documentation for its typedef.
658   - * To remove a previously set filter, invoke this method and pass a nil filterBlock and NULL filterQueue.
659   - *
660   - * Note: This method invokes setSendFilter:withQueue:isAsynchronous: (documented below),
661   - * passing YES for the isAsynchronous parameter.
662   -**/
663   -- (void)setSendFilter:(nullable GCDAsyncUdpSocketSendFilterBlock)filterBlock withQueue:(nullable dispatch_queue_t)filterQueue;
664   -
665   -/**
666   - * The receive filter can be run via dispatch_async or dispatch_sync.
667   - * Most typical situations call for asynchronous operation.
668   - *
669   - * However, there are a few situations in which synchronous operation is preferred.
670   - * Such is the case when the filter is extremely minimal and fast.
671   - * This is because dispatch_sync is faster than dispatch_async.
672   - *
673   - * If you choose synchronous operation, be aware of possible deadlock conditions.
674   - * Since the socket queue is executing your block via dispatch_sync,
675   - * then you cannot perform any tasks which may invoke dispatch_sync on the socket queue.
676   - * For example, you can't query properties on the socket.
677   -**/
678   -- (void)setSendFilter:(nullable GCDAsyncUdpSocketSendFilterBlock)filterBlock
679   - withQueue:(nullable dispatch_queue_t)filterQueue
680   - isAsynchronous:(BOOL)isAsynchronous;
681   -
682   -#pragma mark Receiving
683   -
684   -/**
685   - * There are two modes of operation for receiving packets: one-at-a-time & continuous.
686   - *
687   - * In one-at-a-time mode, you call receiveOnce everytime your delegate is ready to process an incoming udp packet.
688   - * Receiving packets one-at-a-time may be better suited for implementing certain state machine code,
689   - * where your state machine may not always be ready to process incoming packets.
690   - *
691   - * In continuous mode, the delegate is invoked immediately everytime incoming udp packets are received.
692   - * Receiving packets continuously is better suited to real-time streaming applications.
693   - *
694   - * You may switch back and forth between one-at-a-time mode and continuous mode.
695   - * If the socket is currently in continuous mode, calling this method will switch it to one-at-a-time mode.
696   - *
697   - * When a packet is received (and not filtered by the optional receive filter),
698   - * the delegate method (udpSocket:didReceiveData:fromAddress:withFilterContext:) is invoked.
699   - *
700   - * If the socket is able to begin receiving packets, this method returns YES.
701   - * Otherwise it returns NO, and sets the errPtr with appropriate error information.
702   - *
703   - * An example error:
704   - * You created a udp socket to act as a server, and immediately called receive.
705   - * You forgot to first bind the socket to a port number, and received a error with a message like:
706   - * "Must bind socket before you can receive data."
707   -**/
708   -- (BOOL)receiveOnce:(NSError **)errPtr;
709   -
710   -/**
711   - * There are two modes of operation for receiving packets: one-at-a-time & continuous.
712   - *
713   - * In one-at-a-time mode, you call receiveOnce everytime your delegate is ready to process an incoming udp packet.
714   - * Receiving packets one-at-a-time may be better suited for implementing certain state machine code,
715   - * where your state machine may not always be ready to process incoming packets.
716   - *
717   - * In continuous mode, the delegate is invoked immediately everytime incoming udp packets are received.
718   - * Receiving packets continuously is better suited to real-time streaming applications.
719   - *
720   - * You may switch back and forth between one-at-a-time mode and continuous mode.
721   - * If the socket is currently in one-at-a-time mode, calling this method will switch it to continuous mode.
722   - *
723   - * For every received packet (not filtered by the optional receive filter),
724   - * the delegate method (udpSocket:didReceiveData:fromAddress:withFilterContext:) is invoked.
725   - *
726   - * If the socket is able to begin receiving packets, this method returns YES.
727   - * Otherwise it returns NO, and sets the errPtr with appropriate error information.
728   - *
729   - * An example error:
730   - * You created a udp socket to act as a server, and immediately called receive.
731   - * You forgot to first bind the socket to a port number, and received a error with a message like:
732   - * "Must bind socket before you can receive data."
733   -**/
734   -- (BOOL)beginReceiving:(NSError **)errPtr;
735   -
736   -/**
737   - * If the socket is currently receiving (beginReceiving has been called), this method pauses the receiving.
738   - * That is, it won't read any more packets from the underlying OS socket until beginReceiving is called again.
739   - *
740   - * Important Note:
741   - * GCDAsyncUdpSocket may be running in parallel with your code.
742   - * That is, your delegate is likely running on a separate thread/dispatch_queue.
743   - * When you invoke this method, GCDAsyncUdpSocket may have already dispatched delegate methods to be invoked.
744   - * Thus, if those delegate methods have already been dispatch_async'd,
745   - * your didReceive delegate method may still be invoked after this method has been called.
746   - * You should be aware of this, and program defensively.
747   -**/
748   -- (void)pauseReceiving;
749   -
750   -/**
751   - * You may optionally set a receive filter for the socket.
752   - * This receive filter may be set to run in its own queue (independent of delegate queue).
753   - *
754   - * A filter can provide several useful features.
755   - *
756   - * 1. Many times udp packets need to be parsed.
757   - * Since the filter can run in its own independent queue, you can parallelize this parsing quite easily.
758   - * The end result is a parallel socket io, datagram parsing, and packet processing.
759   - *
760   - * 2. Many times udp packets are discarded because they are duplicate/unneeded/unsolicited.
761   - * The filter can prevent such packets from arriving at the delegate.
762   - * And because the filter can run in its own independent queue, this doesn't slow down the delegate.
763   - *
764   - * - Since the udp protocol does not guarantee delivery, udp packets may be lost.
765   - * Many protocols built atop udp thus provide various resend/re-request algorithms.
766   - * This sometimes results in duplicate packets arriving.
767   - * A filter may allow you to architect the duplicate detection code to run in parallel to normal processing.
768   - *
769   - * - Since the udp socket may be connectionless, its possible for unsolicited packets to arrive.
770   - * Such packets need to be ignored.
771   - *
772   - * 3. Sometimes traffic shapers are needed to simulate real world environments.
773   - * A filter allows you to write custom code to simulate such environments.
774   - * The ability to code this yourself is especially helpful when your simulated environment
775   - * is more complicated than simple traffic shaping (e.g. simulating a cone port restricted router),
776   - * or the system tools to handle this aren't available (e.g. on a mobile device).
777   - *
778   - * Example:
779   - *
780   - * GCDAsyncUdpSocketReceiveFilterBlock filter = ^BOOL (NSData *data, NSData *address, id *context) {
781   - *
782   - * MyProtocolMessage *msg = [MyProtocol parseMessage:data];
783   - *
784   - * *context = response;
785   - * return (response != nil);
786   - * };
787   - * [udpSocket setReceiveFilter:filter withQueue:myParsingQueue];
788   - *
789   - * For more information about GCDAsyncUdpSocketReceiveFilterBlock, see the documentation for its typedef.
790   - * To remove a previously set filter, invoke this method and pass a nil filterBlock and NULL filterQueue.
791   - *
792   - * Note: This method invokes setReceiveFilter:withQueue:isAsynchronous: (documented below),
793   - * passing YES for the isAsynchronous parameter.
794   -**/
795   -- (void)setReceiveFilter:(nullable GCDAsyncUdpSocketReceiveFilterBlock)filterBlock withQueue:(nullable dispatch_queue_t)filterQueue;
796   -
797   -/**
798   - * The receive filter can be run via dispatch_async or dispatch_sync.
799   - * Most typical situations call for asynchronous operation.
800   - *
801   - * However, there are a few situations in which synchronous operation is preferred.
802   - * Such is the case when the filter is extremely minimal and fast.
803   - * This is because dispatch_sync is faster than dispatch_async.
804   - *
805   - * If you choose synchronous operation, be aware of possible deadlock conditions.
806   - * Since the socket queue is executing your block via dispatch_sync,
807   - * then you cannot perform any tasks which may invoke dispatch_sync on the socket queue.
808   - * For example, you can't query properties on the socket.
809   -**/
810   -- (void)setReceiveFilter:(nullable GCDAsyncUdpSocketReceiveFilterBlock)filterBlock
811   - withQueue:(nullable dispatch_queue_t)filterQueue
812   - isAsynchronous:(BOOL)isAsynchronous;
813   -
814   -#pragma mark Closing
815   -
816   -/**
817   - * Immediately closes the underlying socket.
818   - * Any pending send operations are discarded.
819   - *
820   - * The GCDAsyncUdpSocket instance may optionally be used again.
821   - * (it will setup/configure/use another unnderlying BSD socket).
822   -**/
823   -- (void)close;
824   -
825   -/**
826   - * Closes the underlying socket after all pending send operations have been sent.
827   - *
828   - * The GCDAsyncUdpSocket instance may optionally be used again.
829   - * (it will setup/configure/use another unnderlying BSD socket).
830   -**/
831   -- (void)closeAfterSending;
832   -
833   -#pragma mark Advanced
834   -/**
835   - * GCDAsyncSocket maintains thread safety by using an internal serial dispatch_queue.
836   - * In most cases, the instance creates this queue itself.
837   - * However, to allow for maximum flexibility, the internal queue may be passed in the init method.
838   - * This allows for some advanced options such as controlling socket priority via target queues.
839   - * However, when one begins to use target queues like this, they open the door to some specific deadlock issues.
840   - *
841   - * For example, imagine there are 2 queues:
842   - * dispatch_queue_t socketQueue;
843   - * dispatch_queue_t socketTargetQueue;
844   - *
845   - * If you do this (pseudo-code):
846   - * socketQueue.targetQueue = socketTargetQueue;
847   - *
848   - * Then all socketQueue operations will actually get run on the given socketTargetQueue.
849   - * This is fine and works great in most situations.
850   - * But if you run code directly from within the socketTargetQueue that accesses the socket,
851   - * you could potentially get deadlock. Imagine the following code:
852   - *
853   - * - (BOOL)socketHasSomething
854   - * {
855   - * __block BOOL result = NO;
856   - * dispatch_block_t block = ^{
857   - * result = [self someInternalMethodToBeRunOnlyOnSocketQueue];
858   - * }
859   - * if (is_executing_on_queue(socketQueue))
860   - * block();
861   - * else
862   - * dispatch_sync(socketQueue, block);
863   - *
864   - * return result;
865   - * }
866   - *
867   - * What happens if you call this method from the socketTargetQueue? The result is deadlock.
868   - * This is because the GCD API offers no mechanism to discover a queue's targetQueue.
869   - * Thus we have no idea if our socketQueue is configured with a targetQueue.
870   - * If we had this information, we could easily avoid deadlock.
871   - * But, since these API's are missing or unfeasible, you'll have to explicitly set it.
872   - *
873   - * IF you pass a socketQueue via the init method,
874   - * AND you've configured the passed socketQueue with a targetQueue,
875   - * THEN you should pass the end queue in the target hierarchy.
876   - *
877   - * For example, consider the following queue hierarchy:
878   - * socketQueue -> ipQueue -> moduleQueue
879   - *
880   - * This example demonstrates priority shaping within some server.
881   - * All incoming client connections from the same IP address are executed on the same target queue.
882   - * And all connections for a particular module are executed on the same target queue.
883   - * Thus, the priority of all networking for the entire module can be changed on the fly.
884   - * Additionally, networking traffic from a single IP cannot monopolize the module.
885   - *
886   - * Here's how you would accomplish something like that:
887   - * - (dispatch_queue_t)newSocketQueueForConnectionFromAddress:(NSData *)address onSocket:(GCDAsyncSocket *)sock
888   - * {
889   - * dispatch_queue_t socketQueue = dispatch_queue_create("", NULL);
890   - * dispatch_queue_t ipQueue = [self ipQueueForAddress:address];
891   - *
892   - * dispatch_set_target_queue(socketQueue, ipQueue);
893   - * dispatch_set_target_queue(iqQueue, moduleQueue);
894   - *
895   - * return socketQueue;
896   - * }
897   - * - (void)socket:(GCDAsyncSocket *)sock didAcceptNewSocket:(GCDAsyncSocket *)newSocket
898   - * {
899   - * [clientConnections addObject:newSocket];
900   - * [newSocket markSocketQueueTargetQueue:moduleQueue];
901   - * }
902   - *
903   - * Note: This workaround is ONLY needed if you intend to execute code directly on the ipQueue or moduleQueue.
904   - * This is often NOT the case, as such queues are used solely for execution shaping.
905   - **/
906   -- (void)markSocketQueueTargetQueue:(dispatch_queue_t)socketQueuesPreConfiguredTargetQueue;
907   -- (void)unmarkSocketQueueTargetQueue:(dispatch_queue_t)socketQueuesPreviouslyConfiguredTargetQueue;
908   -
909   -/**
910   - * It's not thread-safe to access certain variables from outside the socket's internal queue.
911   - *
912   - * For example, the socket file descriptor.
913   - * File descriptors are simply integers which reference an index in the per-process file table.
914   - * However, when one requests a new file descriptor (by opening a file or socket),
915   - * the file descriptor returned is guaranteed to be the lowest numbered unused descriptor.
916   - * So if we're not careful, the following could be possible:
917   - *
918   - * - Thread A invokes a method which returns the socket's file descriptor.
919   - * - The socket is closed via the socket's internal queue on thread B.
920   - * - Thread C opens a file, and subsequently receives the file descriptor that was previously the socket's FD.
921   - * - Thread A is now accessing/altering the file instead of the socket.
922   - *
923   - * In addition to this, other variables are not actually objects,
924   - * and thus cannot be retained/released or even autoreleased.
925   - * An example is the sslContext, of type SSLContextRef, which is actually a malloc'd struct.
926   - *
927   - * Although there are internal variables that make it difficult to maintain thread-safety,
928   - * it is important to provide access to these variables
929   - * to ensure this class can be used in a wide array of environments.
930   - * This method helps to accomplish this by invoking the current block on the socket's internal queue.
931   - * The methods below can be invoked from within the block to access
932   - * those generally thread-unsafe internal variables in a thread-safe manner.
933   - * The given block will be invoked synchronously on the socket's internal queue.
934   - *
935   - * If you save references to any protected variables and use them outside the block, you do so at your own peril.
936   -**/
937   -- (void)performBlock:(dispatch_block_t)block;
938   -
939   -/**
940   - * These methods are only available from within the context of a performBlock: invocation.
941   - * See the documentation for the performBlock: method above.
942   - *
943   - * Provides access to the socket's file descriptor(s).
944   - * If the socket isn't connected, or explicity bound to a particular interface,
945   - * it might actually have multiple internal socket file descriptors - one for IPv4 and one for IPv6.
946   -**/
947   -- (int)socketFD;
948   -- (int)socket4FD;
949   -- (int)socket6FD;
950   -
951   -#if TARGET_OS_IPHONE
952   -
953   -/**
954   - * These methods are only available from within the context of a performBlock: invocation.
955   - * See the documentation for the performBlock: method above.
956   - *
957   - * Returns (creating if necessary) a CFReadStream/CFWriteStream for the internal socket.
958   - *
959   - * Generally GCDAsyncUdpSocket doesn't use CFStream. (It uses the faster GCD API's.)
960   - * However, if you need one for any reason,
961   - * these methods are a convenient way to get access to a safe instance of one.
962   -**/
963   -- (CFReadStreamRef)readStream;
964   -- (CFWriteStreamRef)writeStream;
965   -
966   -/**
967   - * This method is only available from within the context of a performBlock: invocation.
968   - * See the documentation for the performBlock: method above.
969   - *
970   - * Configures the socket to allow it to operate when the iOS application has been backgrounded.
971   - * In other words, this method creates a read & write stream, and invokes:
972   - *
973   - * CFReadStreamSetProperty(readStream, kCFStreamNetworkServiceType, kCFStreamNetworkServiceTypeVoIP);
974   - * CFWriteStreamSetProperty(writeStream, kCFStreamNetworkServiceType, kCFStreamNetworkServiceTypeVoIP);
975   - *
976   - * Returns YES if successful, NO otherwise.
977   - *
978   - * Example usage:
979   - *
980   - * [asyncUdpSocket performBlock:^{
981   - * [asyncUdpSocket enableBackgroundingOnSocket];
982   - * }];
983   - *
984   - *
985   - * NOTE : Apple doesn't currently support backgrounding UDP sockets. (Only TCP for now).
986   -**/
987   -//- (BOOL)enableBackgroundingOnSockets;
988   -
989   -#endif
990   -
991   -#pragma mark Utilities
992   -
993   -/**
994   - * Extracting host/port/family information from raw address data.
995   -**/
996   -
997   -+ (nullable NSString *)hostFromAddress:(NSData *)address;
998   -+ (uint16_t)portFromAddress:(NSData *)address;
999   -+ (int)familyFromAddress:(NSData *)address;
1000   -
1001   -+ (BOOL)isIPv4Address:(NSData *)address;
1002   -+ (BOOL)isIPv6Address:(NSData *)address;
1003   -
1004   -+ (BOOL)getHost:(NSString * __nullable * __nullable)hostPtr port:(uint16_t * __nullable)portPtr fromAddress:(NSData *)address;
1005   -+ (BOOL)getHost:(NSString * __nullable * __nullable)hostPtr port:(uint16_t * __nullable)portPtr family:(int * __nullable)afPtr fromAddress:(NSData *)address;
1006   -
1007   -@end
1008   -
1009   -NS_ASSUME_NONNULL_END
CNLiveXMPPManagerDemo/CocoaAsyncSocket.framework/Info.plist deleted 100644 → 0
View file @b6c7dfc
No preview for this file type
CNLiveXMPPManagerDemo/CocoaAsyncSocket.framework/Modules/module.modulemap deleted 100644 → 0
  View file @b6c7dfc
1   -framework module CocoaAsyncSocket {
2   - umbrella header "CocoaAsyncSocket-umbrella.h"
3   -
4   - export *
5   - module * { export * }
6   -}
CNLiveXMPPManagerDemo/CocoaLumberjack.framework/CocoaLumberjack deleted 100755 → 0
View file @b6c7dfc
No preview for this file type
CNLiveXMPPManagerDemo/CocoaLumberjack.framework/Headers/CocoaLumberjack.h deleted 100644 → 0
  View file @b6c7dfc
1   -// Software License Agreement (BSD License)
2   -//
3   -// Copyright (c) 2010-2016, Deusty, LLC
4   -// All rights reserved.
5   -//
6   -// Redistribution and use of this software in source and binary forms,
7   -// with or without modification, are permitted provided that the following conditions are met:
8   -//
9   -// * Redistributions of source code must retain the above copyright notice,
10   -// this list of conditions and the following disclaimer.
11   -//
12   -// * Neither the name of Deusty nor the names of its contributors may be used
13   -// to endorse or promote products derived from this software without specific
14   -// prior written permission of Deusty, LLC.
15   -
16   -/**
17   - * Welcome to CocoaLumberjack!
18   - *
19   - * The project page has a wealth of documentation if you have any questions.
20   - * https://github.com/CocoaLumberjack/CocoaLumberjack
21   - *
22   - * If you're new to the project you may wish to read "Getting Started" at:
23   - * Documentation/GettingStarted.md
24   - *
25   - * Otherwise, here is a quick refresher.
26   - * There are three steps to using the macros:
27   - *
28   - * Step 1:
29   - * Import the header in your implementation or prefix file:
30   - *
31   - * #import <CocoaLumberjack/CocoaLumberjack.h>
32   - *
33   - * Step 2:
34   - * Define your logging level in your implementation file:
35   - *
36   - * // Log levels: off, error, warn, info, verbose
37   - * static const DDLogLevel ddLogLevel = DDLogLevelVerbose;
38   - *
39   - * Step 2 [3rd party frameworks]:
40   - *
41   - * Define your LOG_LEVEL_DEF to a different variable/function than ddLogLevel:
42   - *
43   - * // #undef LOG_LEVEL_DEF // Undefine first only if needed
44   - * #define LOG_LEVEL_DEF myLibLogLevel
45   - *
46   - * Define your logging level in your implementation file:
47   - *
48   - * // Log levels: off, error, warn, info, verbose
49   - * static const DDLogLevel myLibLogLevel = DDLogLevelVerbose;
50   - *
51   - * Step 3:
52   - * Replace your NSLog statements with DDLog statements according to the severity of the message.
53   - *
54   - * NSLog(@"Fatal error, no dohickey found!"); -> DDLogError(@"Fatal error, no dohickey found!");
55   - *
56   - * DDLog works exactly the same as NSLog.
57   - * This means you can pass it multiple variables just like NSLog.
58   - **/
59   -
60   -#import <Foundation/Foundation.h>
61   -
62   -// Disable legacy macros
63   -#ifndef DD_LEGACY_MACROS
64   - #define DD_LEGACY_MACROS 0
65   -#endif
66   -
67   -// Core
68   -#import "DDLog.h"
69   -
70   -// Main macros
71   -#import "DDLogMacros.h"
72   -#import "DDAssertMacros.h"
73   -
74   -// Capture ASL
75   -#import "DDASLLogCapture.h"
76   -
77   -// Loggers
78   -#import "DDTTYLogger.h"
79   -#import "DDASLLogger.h"
80   -#import "DDFileLogger.h"
81   -
CNLiveXMPPManagerDemo/CocoaLumberjack.framework/Headers/DDASLLogCapture.h deleted 100644 → 0
  View file @b6c7dfc
1   -// Software License Agreement (BSD License)
2   -//
3   -// Copyright (c) 2010-2016, Deusty, LLC
4   -// All rights reserved.
5   -//
6   -// Redistribution and use of this software in source and binary forms,
7   -// with or without modification, are permitted provided that the following conditions are met:
8   -//
9   -// * Redistributions of source code must retain the above copyright notice,
10   -// this list of conditions and the following disclaimer.
11   -//
12   -// * Neither the name of Deusty nor the names of its contributors may be used
13   -// to endorse or promote products derived from this software without specific
14   -// prior written permission of Deusty, LLC.
15   -
16   -#import "DDASLLogger.h"
17   -
18   -@protocol DDLogger;
19   -
20   -/**
21   - * This class provides the ability to capture the ASL (Apple System Logs)
22   - */
23   -@interface DDASLLogCapture : NSObject
24   -
25   -/**
26   - * Start capturing logs
27   - */
28   -+ (void)start;
29   -
30   -/**
31   - * Stop capturing logs
32   - */
33   -+ (void)stop;
34   -
35   -/**
36   - * Returns the current capture level.
37   - * @note Default log level: DDLogLevelVerbose (i.e. capture all ASL messages).
38   - */
39   -+ (DDLogLevel)captureLevel;
40   -
41   -/**
42   - * Set the capture level
43   - *
44   - * @param level new level
45   - */
46   -+ (void)setCaptureLevel:(DDLogLevel)level;
47   -
48   -@end
CNLiveXMPPManagerDemo/CocoaLumberjack.framework/Headers/DDASLLogger.h deleted 100644 → 0
  View file @b6c7dfc
1   -// Software License Agreement (BSD License)
2   -//
3   -// Copyright (c) 2010-2016, Deusty, LLC
4   -// All rights reserved.
5   -//
6   -// Redistribution and use of this software in source and binary forms,
7   -// with or without modification, are permitted provided that the following conditions are met:
8   -//
9   -// * Redistributions of source code must retain the above copyright notice,
10   -// this list of conditions and the following disclaimer.
11   -//
12   -// * Neither the name of Deusty nor the names of its contributors may be used
13   -// to endorse or promote products derived from this software without specific
14   -// prior written permission of Deusty, LLC.
15   -
16   -#import <Foundation/Foundation.h>
17   -
18   -// Disable legacy macros
19   -#ifndef DD_LEGACY_MACROS
20   - #define DD_LEGACY_MACROS 0
21   -#endif
22   -
23   -#import "DDLog.h"
24   -
25   -// Custom key set on messages sent to ASL
26   -extern const char* const kDDASLKeyDDLog;
27   -
28   -// Value set for kDDASLKeyDDLog
29   -extern const char* const kDDASLDDLogValue;
30   -
31   -/**
32   - * This class provides a logger for the Apple System Log facility.
33   - *
34   - * As described in the "Getting Started" page,
35   - * the traditional NSLog() function directs its output to two places:
36   - *
37   - * - Apple System Log
38   - * - StdErr (if stderr is a TTY) so log statements show up in Xcode console
39   - *
40   - * To duplicate NSLog() functionality you can simply add this logger and a tty logger.
41   - * However, if you instead choose to use file logging (for faster performance),
42   - * you may choose to use a file logger and a tty logger.
43   - **/
44   -@interface DDASLLogger : DDAbstractLogger <DDLogger>
45   -
46   -/**
47   - * Singleton method
48   - *
49   - * @return the shared instance
50   - */
51   -+ (instancetype)sharedInstance;
52   -
53   -// Inherited from DDAbstractLogger
54   -
55   -// - (id <DDLogFormatter>)logFormatter;
56   -// - (void)setLogFormatter:(id <DDLogFormatter>)formatter;
57   -
58   -@end
CNLiveXMPPManagerDemo/CocoaLumberjack.framework/Headers/DDAbstractDatabaseLogger.h deleted 100644 → 0
  View file @b6c7dfc
1   -// Software License Agreement (BSD License)
2   -//
3   -// Copyright (c) 2010-2016, Deusty, LLC
4   -// All rights reserved.
5   -//
6   -// Redistribution and use of this software in source and binary forms,
7   -// with or without modification, are permitted provided that the following conditions are met:
8   -//
9   -// * Redistributions of source code must retain the above copyright notice,
10   -// this list of conditions and the following disclaimer.
11   -//
12   -// * Neither the name of Deusty nor the names of its contributors may be used
13   -// to endorse or promote products derived from this software without specific
14   -// prior written permission of Deusty, LLC.
15   -
16   -// Disable legacy macros
17   -#ifndef DD_LEGACY_MACROS
18   - #define DD_LEGACY_MACROS 0
19   -#endif
20   -
21   -#import "DDLog.h"
22   -
23   -/**
24   - * This class provides an abstract implementation of a database logger.
25   - *
26   - * That is, it provides the base implementation for a database logger to build atop of.
27   - * All that is needed for a concrete database logger is to extend this class
28   - * and override the methods in the implementation file that are prefixed with "db_".
29   - **/
30   -@interface DDAbstractDatabaseLogger : DDAbstractLogger {
31   -
32   -@protected
33   - NSUInteger _saveThreshold;
34   - NSTimeInterval _saveInterval;
35   - NSTimeInterval _maxAge;
36   - NSTimeInterval _deleteInterval;
37   - BOOL _deleteOnEverySave;
38   -
39   - BOOL _saveTimerSuspended;
40   - NSUInteger _unsavedCount;
41   - dispatch_time_t _unsavedTime;
42   - dispatch_source_t _saveTimer;
43   - dispatch_time_t _lastDeleteTime;
44   - dispatch_source_t _deleteTimer;
45   -}
46   -
47   -/**
48   - * Specifies how often to save the data to disk.
49   - * Since saving is an expensive operation (disk io) it is not done after every log statement.
50   - * These properties allow you to configure how/when the logger saves to disk.
51   - *
52   - * A save is done when either (whichever happens first):
53   - *
54   - * - The number of unsaved log entries reaches saveThreshold
55   - * - The amount of time since the oldest unsaved log entry was created reaches saveInterval
56   - *
57   - * You can optionally disable the saveThreshold by setting it to zero.
58   - * If you disable the saveThreshold you are entirely dependent on the saveInterval.
59   - *
60   - * You can optionally disable the saveInterval by setting it to zero (or a negative value).
61   - * If you disable the saveInterval you are entirely dependent on the saveThreshold.
62   - *
63   - * It's not wise to disable both saveThreshold and saveInterval.
64   - *
65   - * The default saveThreshold is 500.
66   - * The default saveInterval is 60 seconds.
67   - **/
68   -@property (assign, readwrite) NSUInteger saveThreshold;
69   -
70   -/**
71   - * See the description for the `saveThreshold` property
72   - */
73   -@property (assign, readwrite) NSTimeInterval saveInterval;
74   -
75   -/**
76   - * It is likely you don't want the log entries to persist forever.
77   - * Doing so would allow the database to grow infinitely large over time.
78   - *
79   - * The maxAge property provides a way to specify how old a log statement can get
80   - * before it should get deleted from the database.
81   - *
82   - * The deleteInterval specifies how often to sweep for old log entries.
83   - * Since deleting is an expensive operation (disk io) is is done on a fixed interval.
84   - *
85   - * An alternative to the deleteInterval is the deleteOnEverySave option.
86   - * This specifies that old log entries should be deleted during every save operation.
87   - *
88   - * You can optionally disable the maxAge by setting it to zero (or a negative value).
89   - * If you disable the maxAge then old log statements are not deleted.
90   - *
91   - * You can optionally disable the deleteInterval by setting it to zero (or a negative value).
92   - *
93   - * If you disable both deleteInterval and deleteOnEverySave then old log statements are not deleted.
94   - *
95   - * It's not wise to enable both deleteInterval and deleteOnEverySave.
96   - *
97   - * The default maxAge is 7 days.
98   - * The default deleteInterval is 5 minutes.
99   - * The default deleteOnEverySave is NO.
100   - **/
101   -@property (assign, readwrite) NSTimeInterval maxAge;
102   -
103   -/**
104   - * See the description for the `maxAge` property
105   - */
106   -@property (assign, readwrite) NSTimeInterval deleteInterval;
107   -
108   -/**
109   - * See the description for the `maxAge` property
110   - */
111   -@property (assign, readwrite) BOOL deleteOnEverySave;
112   -
113   -/**
114   - * Forces a save of any pending log entries (flushes log entries to disk).
115   - **/
116   -- (void)savePendingLogEntries;
117   -
118   -/**
119   - * Removes any log entries that are older than maxAge.
120   - **/
121   -- (void)deleteOldLogEntries;
122   -
123   -@end
CNLiveXMPPManagerDemo/CocoaLumberjack.framework/Headers/DDAssertMacros.h deleted 100644 → 0
  View file @b6c7dfc
1   -// Software License Agreement (BSD License)
2   -//
3   -// Copyright (c) 2010-2016, Deusty, LLC
4   -// All rights reserved.
5   -//
6   -// Redistribution and use of this software in source and binary forms,
7   -// with or without modification, are permitted provided that the following conditions are met:
8   -//
9   -// * Redistributions of source code must retain the above copyright notice,
10   -// this list of conditions and the following disclaimer.
11   -//
12   -// * Neither the name of Deusty nor the names of its contributors may be used
13   -// to endorse or promote products derived from this software without specific
14   -// prior written permission of Deusty, LLC.
15   -
16   -/**
17   - * NSAsset replacement that will output a log message even when assertions are disabled.
18   - **/
19   -#define DDAssert(condition, frmt, ...) \
20   - if (!(condition)) { \
21   - NSString *description = [NSString stringWithFormat:frmt, ## __VA_ARGS__]; \
22   - DDLogError(@"%@", description); \
23   - NSAssert(NO, description); \
24   - }
25   -#define DDAssertCondition(condition) DDAssert(condition, @"Condition not satisfied: %s", #condition)
26   -
CNLiveXMPPManagerDemo/CocoaLumberjack.framework/Headers/DDContextFilterLogFormatter.h deleted 100644 → 0
  View file @b6c7dfc
1   -// Software License Agreement (BSD License)
2   -//
3   -// Copyright (c) 2010-2016, Deusty, LLC
4   -// All rights reserved.
5   -//
6   -// Redistribution and use of this software in source and binary forms,
7   -// with or without modification, are permitted provided that the following conditions are met:
8   -//
9   -// * Redistributions of source code must retain the above copyright notice,
10   -// this list of conditions and the following disclaimer.
11   -//
12   -// * Neither the name of Deusty nor the names of its contributors may be used
13   -// to endorse or promote products derived from this software without specific
14   -// prior written permission of Deusty, LLC.
15   -
16   -#import <Foundation/Foundation.h>
17   -
18   -// Disable legacy macros
19   -#ifndef DD_LEGACY_MACROS
20   - #define DD_LEGACY_MACROS 0
21   -#endif
22   -
23   -#import "DDLog.h"
24   -
25   -/**
26   - * This class provides a log formatter that filters log statements from a logging context not on the whitelist.
27   - *
28   - * A log formatter can be added to any logger to format and/or filter its output.
29   - * You can learn more about log formatters here:
30   - * Documentation/CustomFormatters.md
31   - *
32   - * You can learn more about logging context's here:
33   - * Documentation/CustomContext.md
34   - *
35   - * But here's a quick overview / refresher:
36   - *
37   - * Every log statement has a logging context.
38   - * These come from the underlying logging macros defined in DDLog.h.
39   - * The default logging context is zero.
40   - * You can define multiple logging context's for use in your application.
41   - * For example, logically separate parts of your app each have a different logging context.
42   - * Also 3rd party frameworks that make use of Lumberjack generally use their own dedicated logging context.
43   - **/
44   -@interface DDContextWhitelistFilterLogFormatter : NSObject <DDLogFormatter>
45   -
46   -/**
47   - * Designated default initializer
48   - */
49   -- (instancetype)init NS_DESIGNATED_INITIALIZER;
50   -
51   -/**
52   - * Add a context to the whitelist
53   - *
54   - * @param loggingContext the context
55   - */
56   -- (void)addToWhitelist:(NSUInteger)loggingContext;
57   -
58   -/**
59   - * Remove context from whitelist
60   - *
61   - * @param loggingContext the context
62   - */
63   -- (void)removeFromWhitelist:(NSUInteger)loggingContext;
64   -
65   -/**
66   - * Return the whitelist
67   - */
68   -@property (readonly, copy) NSArray *whitelist;
69   -
70   -/**
71   - * Check if a context is on the whitelist
72   - *
73   - * @param loggingContext the context
74   - */
75   -- (BOOL)isOnWhitelist:(NSUInteger)loggingContext;
76   -
77   -@end
78   -
79   -////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
80   -#pragma mark -
81   -////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
82   -
83   -/**
84   - * This class provides a log formatter that filters log statements from a logging context on the blacklist.
85   - **/
86   -@interface DDContextBlacklistFilterLogFormatter : NSObject <DDLogFormatter>
87   -
88   -- (instancetype)init NS_DESIGNATED_INITIALIZER;
89   -
90   -/**
91   - * Add a context to the blacklist
92   - *
93   - * @param loggingContext the context
94   - */
95   -- (void)addToBlacklist:(NSUInteger)loggingContext;
96   -
97   -/**
98   - * Remove context from blacklist
99   - *
100   - * @param loggingContext the context
101   - */
102   -- (void)removeFromBlacklist:(NSUInteger)loggingContext;
103   -
104   -/**
105   - * Return the blacklist
106   - */
107   -@property (readonly, copy) NSArray *blacklist;
108   -
109   -
110   -/**
111   - * Check if a context is on the blacklist
112   - *
113   - * @param loggingContext the context
114   - */
115   -- (BOOL)isOnBlacklist:(NSUInteger)loggingContext;
116   -
117   -@end
CNLiveXMPPManagerDemo/CocoaLumberjack.framework/Headers/DDDispatchQueueLogFormatter.h deleted 100644 → 0
  View file @b6c7dfc
1   -// Software License Agreement (BSD License)
2   -//
3   -// Copyright (c) 2010-2016, Deusty, LLC
4   -// All rights reserved.
5   -//
6   -// Redistribution and use of this software in source and binary forms,
7   -// with or without modification, are permitted provided that the following conditions are met:
8   -//
9   -// * Redistributions of source code must retain the above copyright notice,
10   -// this list of conditions and the following disclaimer.
11   -//
12   -// * Neither the name of Deusty nor the names of its contributors may be used
13   -// to endorse or promote products derived from this software without specific
14   -// prior written permission of Deusty, LLC.
15   -
16   -#import <Foundation/Foundation.h>
17   -#import <libkern/OSAtomic.h>
18   -
19   -// Disable legacy macros
20   -#ifndef DD_LEGACY_MACROS
21   - #define DD_LEGACY_MACROS 0
22   -#endif
23   -
24   -#import "DDLog.h"
25   -
26   -/**
27   - * Log formatter mode
28   - */
29   -typedef NS_ENUM(NSUInteger, DDDispatchQueueLogFormatterMode){
30   - /**
31   - * This is the default option, means the formatter can be reused between multiple loggers and therefore is thread-safe.
32   - * There is, of course, a performance cost for the thread-safety
33   - */
34   - DDDispatchQueueLogFormatterModeShareble = 0,
35   - /**
36   - * If the formatter will only be used by a single logger, then the thread-safety can be removed
37   - * @note: there is an assert checking if the formatter is added to multiple loggers and the mode is non-shareble
38   - */
39   - DDDispatchQueueLogFormatterModeNonShareble,
40   -};
41   -
42   -
43   -/**
44   - * This class provides a log formatter that prints the dispatch_queue label instead of the mach_thread_id.
45   - *
46   - * A log formatter can be added to any logger to format and/or filter its output.
47   - * You can learn more about log formatters here:
48   - * Documentation/CustomFormatters.md
49   - *
50   - * A typical `NSLog` (or `DDTTYLogger`) prints detailed info as `[<process_id>:<thread_id>]`.
51   - * For example:
52   - *
53   - * `2011-10-17 20:21:45.435 AppName[19928:5207] Your log message here`
54   - *
55   - * Where:
56   - * `- 19928 = process id`
57   - * `- 5207 = thread id (mach_thread_id printed in hex)`
58   - *
59   - * When using grand central dispatch (GCD), this information is less useful.
60   - * This is because a single serial dispatch queue may be run on any thread from an internally managed thread pool.
61   - * For example:
62   - *
63   - * `2011-10-17 20:32:31.111 AppName[19954:4d07] Message from my_serial_dispatch_queue`
64   - * `2011-10-17 20:32:31.112 AppName[19954:5207] Message from my_serial_dispatch_queue`
65   - * `2011-10-17 20:32:31.113 AppName[19954:2c55] Message from my_serial_dispatch_queue`
66   - *
67   - * This formatter allows you to replace the standard `[box:info]` with the dispatch_queue name.
68   - * For example:
69   - *
70   - * `2011-10-17 20:32:31.111 AppName[img-scaling] Message from my_serial_dispatch_queue`
71   - * `2011-10-17 20:32:31.112 AppName[img-scaling] Message from my_serial_dispatch_queue`
72   - * `2011-10-17 20:32:31.113 AppName[img-scaling] Message from my_serial_dispatch_queue`
73   - *
74   - * If the dispatch_queue doesn't have a set name, then it falls back to the thread name.
75   - * If the current thread doesn't have a set name, then it falls back to the mach_thread_id in hex (like normal).
76   - *
77   - * Note: If manually creating your own background threads (via `NSThread/alloc/init` or `NSThread/detachNeThread`),
78   - * you can use `[[NSThread currentThread] setName:(NSString *)]`.
79   - **/
80   -@interface DDDispatchQueueLogFormatter : NSObject <DDLogFormatter>
81   -
82   -/**
83   - * Standard init method.
84   - * Configure using properties as desired.
85   - **/
86   -- (instancetype)init NS_DESIGNATED_INITIALIZER;
87   -
88   -/**
89   - * Initializer with ability to set the queue mode
90   - *
91   - * @param mode choose between DDDispatchQueueLogFormatterModeShareble and DDDispatchQueueLogFormatterModeNonShareble, depending if the formatter is shared between several loggers or not
92   - */
93   -- (instancetype)initWithMode:(DDDispatchQueueLogFormatterMode)mode;
94   -
95   -/**
96   - * The minQueueLength restricts the minimum size of the [detail box].
97   - * If the minQueueLength is set to 0, there is no restriction.
98   - *
99   - * For example, say a dispatch_queue has a label of "diskIO":
100   - *
101   - * If the minQueueLength is 0: [diskIO]
102   - * If the minQueueLength is 4: [diskIO]
103   - * If the minQueueLength is 5: [diskIO]
104   - * If the minQueueLength is 6: [diskIO]
105   - * If the minQueueLength is 7: [diskIO ]
106   - * If the minQueueLength is 8: [diskIO ]
107   - *
108   - * The default minQueueLength is 0 (no minimum, so [detail box] won't be padded).
109   - *
110   - * If you want every [detail box] to have the exact same width,
111   - * set both minQueueLength and maxQueueLength to the same value.
112   - **/
113   -@property (assign, atomic) NSUInteger minQueueLength;
114   -
115   -/**
116   - * The maxQueueLength restricts the number of characters that will be inside the [detail box].
117   - * If the maxQueueLength is 0, there is no restriction.
118   - *
119   - * For example, say a dispatch_queue has a label of "diskIO":
120   - *
121   - * If the maxQueueLength is 0: [diskIO]
122   - * If the maxQueueLength is 4: [disk]
123   - * If the maxQueueLength is 5: [diskI]
124   - * If the maxQueueLength is 6: [diskIO]
125   - * If the maxQueueLength is 7: [diskIO]
126   - * If the maxQueueLength is 8: [diskIO]
127   - *
128   - * The default maxQueueLength is 0 (no maximum, so [detail box] won't be truncated).
129   - *
130   - * If you want every [detail box] to have the exact same width,
131   - * set both minQueueLength and maxQueueLength to the same value.
132   - **/
133   -@property (assign, atomic) NSUInteger maxQueueLength;
134   -
135   -/**
136   - * Sometimes queue labels have long names like "com.apple.main-queue",
137   - * but you'd prefer something shorter like simply "main".
138   - *
139   - * This method allows you to set such preferred replacements.
140   - * The above example is set by default.
141   - *
142   - * To remove/undo a previous replacement, invoke this method with nil for the 'shortLabel' parameter.
143   - **/
144   -- (NSString *)replacementStringForQueueLabel:(NSString *)longLabel;
145   -
146   -/**
147   - * See the `replacementStringForQueueLabel:` description
148   - */
149   -- (void)setReplacementString:(NSString *)shortLabel forQueueLabel:(NSString *)longLabel;
150   -
151   -@end
152   -
153   -/**
154   - * Category on `DDDispatchQueueLogFormatter` to make method declarations easier to extend/modify
155   - **/
156   -@interface DDDispatchQueueLogFormatter (OverridableMethods)
157   -
158   -/**
159   - * Date formatter default configuration
160   - */
161   -- (void)configureDateFormatter:(NSDateFormatter *)dateFormatter;
162   -
163   -/**
164   - * Formatter method to transfrom from date to string
165   - */
166   -- (NSString *)stringFromDate:(NSDate *)date;
167   -
168   -/**
169   - * Method to compute the queue thread label
170   - */
171   -- (NSString *)queueThreadLabelForLogMessage:(DDLogMessage *)logMessage;
172   -
173   -/**
174   - * The actual method that formats a message (transforms a `DDLogMessage` model into a printable string)
175   - */
176   -- (NSString *)formatLogMessage:(DDLogMessage *)logMessage;
177   -
178   -@end
CNLiveXMPPManagerDemo/CocoaLumberjack.framework/Headers/DDFileLogger.h deleted 100644 → 0
  View file @b6c7dfc
1   -// Software License Agreement (BSD License)
2   -//
3   -// Copyright (c) 2010-2016, Deusty, LLC
4   -// All rights reserved.
5   -//
6   -// Redistribution and use of this software in source and binary forms,
7   -// with or without modification, are permitted provided that the following conditions are met:
8   -//
9   -// * Redistributions of source code must retain the above copyright notice,
10   -// this list of conditions and the following disclaimer.
11   -//
12   -// * Neither the name of Deusty nor the names of its contributors may be used
13   -// to endorse or promote products derived from this software without specific
14   -// prior written permission of Deusty, LLC.
15   -
16   -// Disable legacy macros
17   -#ifndef DD_LEGACY_MACROS
18   - #define DD_LEGACY_MACROS 0
19   -#endif
20   -
21   -#import "DDLog.h"
22   -
23   -@class DDLogFileInfo;
24   -
25   -/**
26   - * This class provides a logger to write log statements to a file.
27   - **/
28   -
29   -
30   -// Default configuration and safety/sanity values.
31   -//
32   -// maximumFileSize -> kDDDefaultLogMaxFileSize
33   -// rollingFrequency -> kDDDefaultLogRollingFrequency
34   -// maximumNumberOfLogFiles -> kDDDefaultLogMaxNumLogFiles
35   -// logFilesDiskQuota -> kDDDefaultLogFilesDiskQuota
36   -//
37   -// You should carefully consider the proper configuration values for your application.
38   -
39   -extern unsigned long long const kDDDefaultLogMaxFileSize;
40   -extern NSTimeInterval const kDDDefaultLogRollingFrequency;
41   -extern NSUInteger const kDDDefaultLogMaxNumLogFiles;
42   -extern unsigned long long const kDDDefaultLogFilesDiskQuota;
43   -
44   -
45   -////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
46   -#pragma mark -
47   -////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
48   -
49   -/**
50   - * The LogFileManager protocol is designed to allow you to control all aspects of your log files.
51   - *
52   - * The primary purpose of this is to allow you to do something with the log files after they have been rolled.
53   - * Perhaps you want to compress them to save disk space.
54   - * Perhaps you want to upload them to an FTP server.
55   - * Perhaps you want to run some analytics on the file.
56   - *
57   - * A default LogFileManager is, of course, provided.
58   - * The default LogFileManager simply deletes old log files according to the maximumNumberOfLogFiles property.
59   - *
60   - * This protocol provides various methods to fetch the list of log files.
61   - *
62   - * There are two variants: sorted and unsorted.
63   - * If sorting is not necessary, the unsorted variant is obviously faster.
64   - * The sorted variant will return an array sorted by when the log files were created,
65   - * with the most recently created log file at index 0, and the oldest log file at the end of the array.
66   - *
67   - * You can fetch only the log file paths (full path including name), log file names (name only),
68   - * or an array of `DDLogFileInfo` objects.
69   - * The `DDLogFileInfo` class is documented below, and provides a handy wrapper that
70   - * gives you easy access to various file attributes such as the creation date or the file size.
71   - */
72   -@protocol DDLogFileManager <NSObject>
73   -@required
74   -
75   -// Public properties
76   -
77   -/**
78   - * The maximum number of archived log files to keep on disk.
79   - * For example, if this property is set to 3,
80   - * then the LogFileManager will only keep 3 archived log files (plus the current active log file) on disk.
81   - * Once the active log file is rolled/archived, then the oldest of the existing 3 rolled/archived log files is deleted.
82   - *
83   - * You may optionally disable this option by setting it to zero.
84   - **/
85   -@property (readwrite, assign, atomic) NSUInteger maximumNumberOfLogFiles;
86   -
87   -/**
88   - * The maximum space that logs can take. On rolling logfile all old logfiles that exceed logFilesDiskQuota will
89   - * be deleted.
90   - *
91   - * You may optionally disable this option by setting it to zero.
92   - **/
93   -@property (readwrite, assign, atomic) unsigned long long logFilesDiskQuota;
94   -
95   -// Public methods
96   -
97   -/**
98   - * Returns the logs directory (path)
99   - */
100   -- (NSString *)logsDirectory;
101   -
102   -/**
103   - * Returns an array of `NSString` objects,
104   - * each of which is the filePath to an existing log file on disk.
105   - **/
106   -- (NSArray *)unsortedLogFilePaths;
107   -
108   -/**
109   - * Returns an array of `NSString` objects,
110   - * each of which is the fileName of an existing log file on disk.
111   - **/
112   -- (NSArray *)unsortedLogFileNames;
113   -
114   -/**
115   - * Returns an array of `DDLogFileInfo` objects,
116   - * each representing an existing log file on disk,
117   - * and containing important information about the log file such as it's modification date and size.
118   - **/
119   -- (NSArray *)unsortedLogFileInfos;
120   -
121   -/**
122   - * Just like the `unsortedLogFilePaths` method, but sorts the array.
123   - * The items in the array are sorted by creation date.
124   - * The first item in the array will be the most recently created log file.
125   - **/
126   -- (NSArray *)sortedLogFilePaths;
127   -
128   -/**
129   - * Just like the `unsortedLogFileNames` method, but sorts the array.
130   - * The items in the array are sorted by creation date.
131   - * The first item in the array will be the most recently created log file.
132   - **/
133   -- (NSArray *)sortedLogFileNames;
134   -
135   -/**
136   - * Just like the `unsortedLogFileInfos` method, but sorts the array.
137   - * The items in the array are sorted by creation date.
138   - * The first item in the array will be the most recently created log file.
139   - **/
140   -- (NSArray *)sortedLogFileInfos;
141   -
142   -// Private methods (only to be used by DDFileLogger)
143   -
144   -/**
145   - * Generates a new unique log file path, and creates the corresponding log file.
146   - **/
147   -- (NSString *)createNewLogFile;
148   -
149   -@optional
150   -
151   -// Notifications from DDFileLogger
152   -
153   -/**
154   - * Called when a log file was archieved
155   - */
156   -- (void)didArchiveLogFile:(NSString *)logFilePath;
157   -
158   -/**
159   - * Called when the roll action was executed and the log was archieved
160   - */
161   -- (void)didRollAndArchiveLogFile:(NSString *)logFilePath;
162   -
163   -@end
164   -
165   -////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
166   -#pragma mark -
167   -////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
168   -
169   -/**
170   - * Default log file manager.
171   - *
172   - * All log files are placed inside the logsDirectory.
173   - * If a specific logsDirectory isn't specified, the default directory is used.
174   - * On Mac, this is in `~/Library/Logs/<Application Name>`.
175   - * On iPhone, this is in `~/Library/Caches/Logs`.
176   - *
177   - * Log files are named `"<bundle identifier> <date> <time>.log"`
178   - * Example: `com.organization.myapp 2013-12-03 17-14.log`
179   - *
180   - * Archived log files are automatically deleted according to the `maximumNumberOfLogFiles` property.
181   - **/
182   -@interface DDLogFileManagerDefault : NSObject <DDLogFileManager>
183   -
184   -/**
185   - * Default initializer
186   - */
187   -- (instancetype)init;
188   -
189   -/**
190   - * Designated initialized, requires the logs directory
191   - */
192   -- (instancetype)initWithLogsDirectory:(NSString *)logsDirectory NS_DESIGNATED_INITIALIZER;
193   -
194   -#if TARGET_OS_IPHONE
195   -/*
196   - * Calling this constructor you can override the default "automagically" chosen NSFileProtection level.
197   - * Useful if you are writing a command line utility / CydiaSubstrate addon for iOS that has no NSBundle
198   - * or like SpringBoard no BackgroundModes key in the NSBundle:
199   - * iPhone:~ root# cycript -p SpringBoard
200   - * cy# [NSBundle mainBundle]
201   - * #"NSBundle </System/Library/CoreServices/SpringBoard.app> (loaded)"
202   - * cy# [[NSBundle mainBundle] objectForInfoDictionaryKey:@"UIBackgroundModes"];
203   - * null
204   - * cy#
205   - **/
206   -- (instancetype)initWithLogsDirectory:(NSString *)logsDirectory defaultFileProtectionLevel:(NSString *)fileProtectionLevel;
207   -#endif
208   -
209   -/*
210   - * Methods to override.
211   - *
212   - * Log files are named `"<bundle identifier> <date> <time>.log"`
213   - * Example: `com.organization.myapp 2013-12-03 17-14.log`
214   - *
215   - * If you wish to change default filename, you can override following two methods.
216   - * - `newLogFileName` method would be called on new logfile creation.
217   - * - `isLogFile:` method would be called to filter logfiles from all other files in logsDirectory.
218   - * You have to parse given filename and return YES if it is logFile.
219   - *
220   - * **NOTE**
221   - * `newLogFileName` returns filename. If appropriate file already exists, number would be added
222   - * to filename before extension. You have to handle this case in isLogFile: method.
223   - *
224   - * Example:
225   - * - newLogFileName returns `"com.organization.myapp 2013-12-03.log"`,
226   - * file `"com.organization.myapp 2013-12-03.log"` would be created.
227   - * - after some time `"com.organization.myapp 2013-12-03.log"` is archived
228   - * - newLogFileName again returns `"com.organization.myapp 2013-12-03.log"`,
229   - * file `"com.organization.myapp 2013-12-03 2.log"` would be created.
230   - * - after some time `"com.organization.myapp 2013-12-03 1.log"` is archived
231   - * - newLogFileName again returns `"com.organization.myapp 2013-12-03.log"`,
232   - * file `"com.organization.myapp 2013-12-03 3.log"` would be created.
233   - **/
234   -
235   -/**
236   - * Generates log file name with default format `"<bundle identifier> <date> <time>.log"`
237   - * Example: `MobileSafari 2013-12-03 17-14.log`
238   - *
239   - * You can change it by overriding `newLogFileName` and `isLogFile:` methods.
240   - **/
241   -@property (readonly, copy) NSString *newLogFileName;
242   -
243   -/**
244   - * Default log file name is `"<bundle identifier> <date> <time>.log"`.
245   - * Example: `MobileSafari 2013-12-03 17-14.log`
246   - *
247   - * You can change it by overriding `newLogFileName` and `isLogFile:` methods.
248   - **/
249   -- (BOOL)isLogFile:(NSString *)fileName;
250   -
251   -/* Inherited from DDLogFileManager protocol:
252   -
253   - @property (readwrite, assign, atomic) NSUInteger maximumNumberOfLogFiles;
254   - @property (readwrite, assign, atomic) NSUInteger logFilesDiskQuota;
255   -
256   - - (NSString *)logsDirectory;
257   -
258   - - (NSArray *)unsortedLogFilePaths;
259   - - (NSArray *)unsortedLogFileNames;
260   - - (NSArray *)unsortedLogFileInfos;
261   -
262   - - (NSArray *)sortedLogFilePaths;
263   - - (NSArray *)sortedLogFileNames;
264   - - (NSArray *)sortedLogFileInfos;
265   -
266   - */
267   -
268   -@end
269   -
270   -////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
271   -#pragma mark -
272   -////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
273   -
274   -/**
275   - * Most users will want file log messages to be prepended with the date and time.
276   - * Rather than forcing the majority of users to write their own formatter,
277   - * we will supply a logical default formatter.
278   - * Users can easily replace this formatter with their own by invoking the `setLogFormatter:` method.
279   - * It can also be removed by calling `setLogFormatter:`, and passing a nil parameter.
280   - *
281   - * In addition to the convenience of having a logical default formatter,
282   - * it will also provide a template that makes it easy for developers to copy and change.
283   - **/
284   -@interface DDLogFileFormatterDefault : NSObject <DDLogFormatter>
285   -
286   -/**
287   - * Default initializer
288   - */
289   -- (instancetype)init;
290   -
291   -/**
292   - * Designated initializer, requires a date formatter
293   - */
294   -- (instancetype)initWithDateFormatter:(NSDateFormatter *)dateFormatter NS_DESIGNATED_INITIALIZER;
295   -
296   -@end
297   -
298   -////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
299   -#pragma mark -
300   -////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
301   -
302   -/**
303   - * The standard implementation for a file logger
304   - */
305   -@interface DDFileLogger : DDAbstractLogger <DDLogger>
306   -
307   -/**
308   - * Default initializer
309   - */
310   -- (instancetype)init;
311   -
312   -/**
313   - * Designated initializer, requires a `DDLogFileManager` instance
314   - */
315   -- (instancetype)initWithLogFileManager:(id <DDLogFileManager>)logFileManager NS_DESIGNATED_INITIALIZER;
316   -
317   -/**
318   - * Log File Rolling:
319   - *
320   - * `maximumFileSize`:
321   - * The approximate maximum size to allow log files to grow.
322   - * If a log file is larger than this value after a log statement is appended,
323   - * then the log file is rolled.
324   - *
325   - * `rollingFrequency`
326   - * How often to roll the log file.
327   - * The frequency is given as an `NSTimeInterval`, which is a double that specifies the interval in seconds.
328   - * Once the log file gets to be this old, it is rolled.
329   - *
330   - * Both the `maximumFileSize` and the `rollingFrequency` are used to manage rolling.
331   - * Whichever occurs first will cause the log file to be rolled.
332   - *
333   - * For example:
334   - * The `rollingFrequency` is 24 hours,
335   - * but the log file surpasses the `maximumFileSize` after only 20 hours.
336   - * The log file will be rolled at that 20 hour mark.
337   - * A new log file will be created, and the 24 hour timer will be restarted.
338   - *
339   - * You may optionally disable rolling due to filesize by setting `maximumFileSize` to zero.
340   - * If you do so, rolling is based solely on `rollingFrequency`.
341   - *
342   - * You may optionally disable rolling due to time by setting `rollingFrequency` to zero (or any non-positive number).
343   - * If you do so, rolling is based solely on `maximumFileSize`.
344   - *
345   - * If you disable both `maximumFileSize` and `rollingFrequency`, then the log file won't ever be rolled.
346   - * This is strongly discouraged.
347   - **/
348   -@property (readwrite, assign) unsigned long long maximumFileSize;
349   -
350   -/**
351   - * See description for `maximumFileSize`
352   - */
353   -@property (readwrite, assign) NSTimeInterval rollingFrequency;
354   -
355   -/**
356   - * See description for `maximumFileSize`
357   - */
358   -@property (readwrite, assign, atomic) BOOL doNotReuseLogFiles;
359   -
360   -/**
361   - * The DDLogFileManager instance can be used to retrieve the list of log files,
362   - * and configure the maximum number of archived log files to keep.
363   - *
364   - * @see DDLogFileManager.maximumNumberOfLogFiles
365   - **/
366   -@property (strong, nonatomic, readonly) id <DDLogFileManager> logFileManager;
367   -
368   -/**
369   - * When using a custom formatter you can set the `logMessage` method not to append
370   - * `\n` character after each output. This allows for some greater flexibility with
371   - * custom formatters. Default value is YES.
372   - **/
373   -@property (nonatomic, readwrite, assign) BOOL automaticallyAppendNewlineForCustomFormatters;
374   -
375   -/**
376   - * You can optionally force the current log file to be rolled with this method.
377   - * CompletionBlock will be called on main queue.
378   - */
379   -- (void)rollLogFileWithCompletionBlock:(void (^)())completionBlock;
380   -
381   -/**
382   - * Method is deprecated.
383   - * @deprecated Use `rollLogFileWithCompletionBlock:` method instead.
384   - */
385   -- (void)rollLogFile __attribute((deprecated));
386   -
387   -// Inherited from DDAbstractLogger
388   -
389   -// - (id <DDLogFormatter>)logFormatter;
390   -// - (void)setLogFormatter:(id <DDLogFormatter>)formatter;
391   -
392   -/**
393   - * Returns the log file that should be used.
394   - * If there is an existing log file that is suitable,
395   - * within the constraints of `maximumFileSize` and `rollingFrequency`, then it is returned.
396   - *
397   - * Otherwise a new file is created and returned.
398   - **/
399   -- (DDLogFileInfo *)currentLogFileInfo;
400   -
401   -@end
402   -
403   -////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
404   -#pragma mark -
405   -////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
406   -
407   -/**
408   - * `DDLogFileInfo` is a simple class that provides access to various file attributes.
409   - * It provides good performance as it only fetches the information if requested,
410   - * and it caches the information to prevent duplicate fetches.
411   - *
412   - * It was designed to provide quick snapshots of the current state of log files,
413   - * and to help sort log files in an array.
414   - *
415   - * This class does not monitor the files, or update it's cached attribute values if the file changes on disk.
416   - * This is not what the class was designed for.
417   - *
418   - * If you absolutely must get updated values,
419   - * you can invoke the reset method which will clear the cache.
420   - **/
421   -@interface DDLogFileInfo : NSObject
422   -
423   -@property (strong, nonatomic, readonly) NSString *filePath;
424   -@property (strong, nonatomic, readonly) NSString *fileName;
425   -
426   -@property (strong, nonatomic, readonly) NSDictionary *fileAttributes;
427   -
428   -@property (strong, nonatomic, readonly) NSDate *creationDate;
429   -@property (strong, nonatomic, readonly) NSDate *modificationDate;
430   -
431   -@property (nonatomic, readonly) unsigned long long fileSize;
432   -
433   -@property (nonatomic, readonly) NSTimeInterval age;
434   -
435   -@property (nonatomic, readwrite) BOOL isArchived;
436   -
437   -+ (instancetype)logFileWithPath:(NSString *)filePath;
438   -
439   -- (instancetype)init NS_UNAVAILABLE;
440   -- (instancetype)initWithFilePath:(NSString *)filePath NS_DESIGNATED_INITIALIZER;
441   -
442   -- (void)reset;
443   -- (void)renameFile:(NSString *)newFileName;
444   -
445   -#if TARGET_IPHONE_SIMULATOR
446   -
447   -// So here's the situation.
448   -// Extended attributes are perfect for what we're trying to do here (marking files as archived).
449   -// This is exactly what extended attributes were designed for.
450   -//
451   -// But Apple screws us over on the simulator.
452   -// Everytime you build-and-go, they copy the application into a new folder on the hard drive,
453   -// and as part of the process they strip extended attributes from our log files.
454   -// Normally, a copy of a file preserves extended attributes.
455   -// So obviously Apple has gone to great lengths to piss us off.
456   -//
457   -// Thus we use a slightly different tactic for marking log files as archived in the simulator.
458   -// That way it "just works" and there's no confusion when testing.
459   -//
460   -// The difference in method names is indicative of the difference in functionality.
461   -// On the simulator we add an attribute by appending a filename extension.
462   -//
463   -// For example:
464   -// "mylog.txt" -> "mylog.archived.txt"
465   -// "mylog" -> "mylog.archived"
466   -
467   -- (BOOL)hasExtensionAttributeWithName:(NSString *)attrName;
468   -
469   -- (void)addExtensionAttributeWithName:(NSString *)attrName;
470   -- (void)removeExtensionAttributeWithName:(NSString *)attrName;
471   -
472   -#else /* if TARGET_IPHONE_SIMULATOR */
473   -
474   -// Normal use of extended attributes used everywhere else,
475   -// such as on Macs and on iPhone devices.
476   -
477   -- (BOOL)hasExtendedAttributeWithName:(NSString *)attrName;
478   -
479   -- (void)addExtendedAttributeWithName:(NSString *)attrName;
480   -- (void)removeExtendedAttributeWithName:(NSString *)attrName;
481   -
482   -#endif /* if TARGET_IPHONE_SIMULATOR */
483   -
484   -- (NSComparisonResult)reverseCompareByCreationDate:(DDLogFileInfo *)another;
485   -- (NSComparisonResult)reverseCompareByModificationDate:(DDLogFileInfo *)another;
486   -
487   -@end
CNLiveXMPPManagerDemo/CocoaLumberjack.framework/Headers/DDLegacyMacros.h deleted 100644 → 0
  View file @b6c7dfc
1   -// Software License Agreement (BSD License)
2   -//
3   -// Copyright (c) 2010-2016, Deusty, LLC
4   -// All rights reserved.
5   -//
6   -// Redistribution and use of this software in source and binary forms,
7   -// with or without modification, are permitted provided that the following conditions are met:
8   -//
9   -// * Redistributions of source code must retain the above copyright notice,
10   -// this list of conditions and the following disclaimer.
11   -//
12   -// * Neither the name of Deusty nor the names of its contributors may be used
13   -// to endorse or promote products derived from this software without specific
14   -// prior written permission of Deusty, LLC.
15   -
16   -/**
17   - * Legacy macros used for 1.9.x backwards compatibility.
18   - *
19   - * Imported by default when importing a DDLog.h directly and DD_LEGACY_MACROS is not defined and set to 0.
20   - **/
21   -#if DD_LEGACY_MACROS
22   -
23   -#warning CocoaLumberjack 1.9.x legacy macros enabled. \
24   -Disable legacy macros by importing CocoaLumberjack.h or DDLogMacros.h instead of DDLog.h or add `#define DD_LEGACY_MACROS 0` before importing DDLog.h.
25   -
26   -#ifndef LOG_LEVEL_DEF
27   - #define LOG_LEVEL_DEF ddLogLevel
28   -#endif
29   -
30   -#define LOG_FLAG_ERROR DDLogFlagError
31   -#define LOG_FLAG_WARN DDLogFlagWarning
32   -#define LOG_FLAG_INFO DDLogFlagInfo
33   -#define LOG_FLAG_DEBUG DDLogFlagDebug
34   -#define LOG_FLAG_VERBOSE DDLogFlagVerbose
35   -
36   -#define LOG_LEVEL_OFF DDLogLevelOff
37   -#define LOG_LEVEL_ERROR DDLogLevelError
38   -#define LOG_LEVEL_WARN DDLogLevelWarning
39   -#define LOG_LEVEL_INFO DDLogLevelInfo
40   -#define LOG_LEVEL_DEBUG DDLogLevelDebug
41   -#define LOG_LEVEL_VERBOSE DDLogLevelVerbose
42   -#define LOG_LEVEL_ALL DDLogLevelAll
43   -
44   -#define LOG_ASYNC_ENABLED YES
45   -
46   -#define LOG_ASYNC_ERROR ( NO && LOG_ASYNC_ENABLED)
47   -#define LOG_ASYNC_WARN (YES && LOG_ASYNC_ENABLED)
48   -#define LOG_ASYNC_INFO (YES && LOG_ASYNC_ENABLED)
49   -#define LOG_ASYNC_DEBUG (YES && LOG_ASYNC_ENABLED)
50   -#define LOG_ASYNC_VERBOSE (YES && LOG_ASYNC_ENABLED)
51   -
52   -#define LOG_MACRO(isAsynchronous, lvl, flg, ctx, atag, fnct, frmt, ...) \
53   - [DDLog log : isAsynchronous \
54   - level : lvl \
55   - flag : flg \
56   - context : ctx \
57   - file : __FILE__ \
58   - function : fnct \
59   - line : __LINE__ \
60   - tag : atag \
61   - format : (frmt), ## __VA_ARGS__]
62   -
63   -#define LOG_MAYBE(async, lvl, flg, ctx, fnct, frmt, ...) \
64   - do { if(lvl & flg) LOG_MACRO(async, lvl, flg, ctx, nil, fnct, frmt, ##__VA_ARGS__); } while(0)
65   -
66   -#define LOG_OBJC_MAYBE(async, lvl, flg, ctx, frmt, ...) \
67   - LOG_MAYBE(async, lvl, flg, ctx, __PRETTY_FUNCTION__, frmt, ## __VA_ARGS__)
68   -
69   -#define DDLogError(frmt, ...) LOG_OBJC_MAYBE(LOG_ASYNC_ERROR, LOG_LEVEL_DEF, LOG_FLAG_ERROR, 0, frmt, ##__VA_ARGS__)
70   -#define DDLogWarn(frmt, ...) LOG_OBJC_MAYBE(LOG_ASYNC_WARN, LOG_LEVEL_DEF, LOG_FLAG_WARN, 0, frmt, ##__VA_ARGS__)
71   -#define DDLogInfo(frmt, ...) LOG_OBJC_MAYBE(LOG_ASYNC_INFO, LOG_LEVEL_DEF, LOG_FLAG_INFO, 0, frmt, ##__VA_ARGS__)
72   -#define DDLogDebug(frmt, ...) LOG_OBJC_MAYBE(LOG_ASYNC_DEBUG, LOG_LEVEL_DEF, LOG_FLAG_DEBUG, 0, frmt, ##__VA_ARGS__)
73   -#define DDLogVerbose(frmt, ...) LOG_OBJC_MAYBE(LOG_ASYNC_VERBOSE, LOG_LEVEL_DEF, LOG_FLAG_VERBOSE, 0, frmt, ##__VA_ARGS__)
74   -
75   -#endif
CNLiveXMPPManagerDemo/CocoaLumberjack.framework/Headers/DDLog+LOGV.h deleted 100644 → 0
  View file @b6c7dfc
1   -// Software License Agreement (BSD License)
2   -//
3   -// Copyright (c) 2010-2016, Deusty, LLC
4   -// All rights reserved.
5   -//
6   -// Redistribution and use of this software in source and binary forms,
7   -// with or without modification, are permitted provided that the following conditions are met:
8   -//
9   -// * Redistributions of source code must retain the above copyright notice,
10   -// this list of conditions and the following disclaimer.
11   -//
12   -// * Neither the name of Deusty nor the names of its contributors may be used
13   -// to endorse or promote products derived from this software without specific
14   -// prior written permission of Deusty, LLC.
15   -
16   -// Disable legacy macros
17   -#ifndef DD_LEGACY_MACROS
18   - #define DD_LEGACY_MACROS 0
19   -#endif
20   -
21   -#import "DDLog.h"
22   -
23   -/**
24   - * The constant/variable/method responsible for controlling the current log level.
25   - **/
26   -#ifndef LOG_LEVEL_DEF
27   - #define LOG_LEVEL_DEF ddLogLevel
28   -#endif
29   -
30   -/**
31   - * Whether async should be used by log messages, excluding error messages that are always sent sync.
32   - **/
33   -#ifndef LOG_ASYNC_ENABLED
34   - #define LOG_ASYNC_ENABLED YES
35   -#endif
36   -
37   -/**
38   - * This is the single macro that all other macros below compile into.
39   - * This big multiline macro makes all the other macros easier to read.
40   - **/
41   -#define LOGV_MACRO(isAsynchronous, lvl, flg, ctx, atag, fnct, frmt, avalist) \
42   - [DDLog log : isAsynchronous \
43   - level : lvl \
44   - flag : flg \
45   - context : ctx \
46   - file : __FILE__ \
47   - function : fnct \
48   - line : __LINE__ \
49   - tag : atag \
50   - format : frmt \
51   - args : avalist]
52   -
53   -/**
54   - * Define version of the macro that only execute if the log level is above the threshold.
55   - * The compiled versions essentially look like this:
56   - *
57   - * if (logFlagForThisLogMsg & ddLogLevel) { execute log message }
58   - *
59   - * When LOG_LEVEL_DEF is defined as ddLogLevel.
60   - *
61   - * As shown further below, Lumberjack actually uses a bitmask as opposed to primitive log levels.
62   - * This allows for a great amount of flexibility and some pretty advanced fine grained logging techniques.
63   - *
64   - * Note that when compiler optimizations are enabled (as they are for your release builds),
65   - * the log messages above your logging threshold will automatically be compiled out.
66   - *
67   - * (If the compiler sees LOG_LEVEL_DEF/ddLogLevel declared as a constant, the compiler simply checks to see
68   - * if the 'if' statement would execute, and if not it strips it from the binary.)
69   - *
70   - * We also define shorthand versions for asynchronous and synchronous logging.
71   - **/
72   -#define LOGV_MAYBE(async, lvl, flg, ctx, tag, fnct, frmt, avalist) \
73   - do { if(lvl & flg) LOGV_MACRO(async, lvl, flg, ctx, tag, fnct, frmt, avalist); } while(0)
74   -
75   -/**
76   - * Ready to use log macros with no context or tag.
77   - **/
78   -#define DDLogVError(frmt, avalist) LOGV_MAYBE(NO, LOG_LEVEL_DEF, DDLogFlagError, 0, nil, __PRETTY_FUNCTION__, frmt, avalist)
79   -#define DDLogVWarn(frmt, avalist) LOGV_MAYBE(LOG_ASYNC_ENABLED, LOG_LEVEL_DEF, DDLogFlagWarning, 0, nil, __PRETTY_FUNCTION__, frmt, avalist)
80   -#define DDLogVInfo(frmt, avalist) LOGV_MAYBE(LOG_ASYNC_ENABLED, LOG_LEVEL_DEF, DDLogFlagInfo, 0, nil, __PRETTY_FUNCTION__, frmt, avalist)
81   -#define DDLogVDebug(frmt, avalist) LOGV_MAYBE(LOG_ASYNC_ENABLED, LOG_LEVEL_DEF, DDLogFlagDebug, 0, nil, __PRETTY_FUNCTION__, frmt, avalist)
82   -#define DDLogVVerbose(frmt, avalist) LOGV_MAYBE(LOG_ASYNC_ENABLED, LOG_LEVEL_DEF, DDLogFlagVerbose, 0, nil, __PRETTY_FUNCTION__, frmt, avalist)
83   -