Upgrade to Pro — share decks privately, control downloads, hide ads and more …

Objective-C Programming Guide for Open Source Software

Objective-C Programming Guide for Open Source Software

2014/02/01 @ GREE

Yosuke Ishikawa

February 01, 2014
Tweet

More Decks by Yosuke Ishikawa

Other Decks in Technology

Transcript

  1. ެ։༻ͷObjective-Cͷॻ͖ํ
    @_ishkawa

    View Slide

  2. ࣗݾ঺հ

    View Slide

  3. View Slide

  4. GHFeed

    View Slide

  5. IS
    ISDiskCache
    ISMemoryCache
    ISHTTPOperation
    ISRemoveNull
    ISPersistentStack
    ISMethodSwizzling
    ISBackGesture
    ISRefreshControl
    ISColumnsController
    ISRevealController
    ISCyclicPagesView
    ISFakeInterfaceOrientation
    ISInteractiveEdgesNavigationBar
    ISAlternativeRefreshControl

    View Slide

  6. View Slide

  7. 8 Pods
    551 Stars

    View Slide

  8. τʔΫ֓ཁ

    View Slide

  9. “ެ։༻”
    | |
    ଞਓ΋࢖͏ίʔυ

    View Slide

  10. ࣗ෼͔͠৮Δ͜ͱͷͳ͍ΞϓϦͷ
    ίʔυ͸޷͖ͳΑ͏ʹॻ͚͹͍͍
    (ࣗݾ੹೚Ͱ)

    View Slide

  11. ͔͠͠ɺଞਓ΋৮ΔՄೳੑ͕͋Δ৔߹͸

    View Slide

  12. ✓ ୭Ͱ΋؆୯ʹಋೖͰ͖Δ
    ✓ ୭Ͱ΋ਖ਼͘͠ѻ͏͜ͱ͕Ͱ͖Δ
    ✓ ଞͷίʔυ΁ͷ෭࡞༻͕ͳ͍
    ✓ γϯϘϧ΍Ϧιʔε͕িಥ͠ͳ͍
    ͱ͍ͬͨ͜ͱ͕ٻΊΒΕΔͷͰɺࠓ೔͸ͦͷ࿩Λ͠·͢ɻ

    View Slide

  13. 1.ΞϓϦͱͷিಥ
    2.ྑ͍@interface
    3.Ϣχοτςετ
    τʔΫ֓ཁ

    View Slide

  14. 1.ΞϓϦͱͷিಥ

    View Slide

  15. 2छྨͷিಥ
    ✗ γϯϘϧͷিಥ
    ✗ Ϧιʔεͷিಥ

    View Slide

  16. 1.1.γϯϘϧͷিಥ

    View Slide

  17. ✗ Ϋϥεͷিಥ
    ✗ ΧςΰϦͷϝιουͷিಥ
    ✗ ఆ਺ͷিಥ

    View Slide

  18. Duplicated Symbol !!!

    View Slide

  19. View Slide

  20. γϯϘϧͷিಥ͸໋໊نଇͰ๷͙͜ͱ͕Ͱ͖Δ
    ʢେ఍ͷ৔߹ʣ

    View Slide

  21. 1.1.1.Ϋϥεͷ໋໊نଇ

    View Slide

  22. ✓ 3จࣈͷେจࣈprefixΛ͚ͭΔ
    @interface ISHObject : NSObject
    !
    @end

    View Slide

  23. Objective-CʹΑΔϓϩάϥϛϯά (p.127)
    “ಠࣗͷΫϥεʹ͸3จࣈͷϓϨϑΟοΫεΛ͚͍ͭͯͩ͘͞ɻ ձ໊ࣾ
    ΍ΞϓϦέʔγϣϯ໊ʹͪͳΜͩ΋ͷͰ΋ɺॏཁͳίϯϙʔωϯτʹ
    ༝དྷ͢Δ΋ͷͰ΋ߏ͍·ͤΜɻ”
    “ͨͱ͑͹ɺձ໊͕ࣾWhispering Oakɺ։ൃ͢ΔήʔϜͷ໊લ͕Zebra
    SurpriseͰ͋Ε͹ɺ WZS΍WOZͱ͍ͬͨϓϨϑΟοΫεʹ͢ΔͱΑ͍
    ͔΋͠Ε·ͤΜɻ”

    View Slide

  24. Objective-CʹΑΔϓϩάϥϛϯά (p.126)
    “2จࣈͷϓϨϑΟοΫε͸ɺϑϨʔϜϫʔΫΫϥεʹ࢖͏ͨΊɺ
    Apple͕༧໿͍ͯ͠·͢ɻ”
    ✗ IS
    ✓ NJK

    View Slide

  25. 1.1.2.ΧςΰϦͷϝιουͷ໋໊نଇ

    View Slide

  26. ✓ 3จࣈͷখจࣈprefixΛ͚ͭΔ
    @interface NSObject (ISHAdditions)
    !
    - (void)ish_additionalMethod;
    !
    @end

    View Slide

  27. Objective-CʹΑΔϓϩάϥϛϯά (p.74)
    “Ϋϥε໊ͷϓϨϑΟοΫεͱಉ͡3จࣈͷจࣈྻΛɺϝιου໊
    ͷن໿ʹैͬͯখจࣈʹ͠ɺΞϯμʔείΞΛ͸͞ΜͰϝιου
    ໊ͱ࿈͍݁ͯͩ͘͠͞ɻ”
    “ಈ࡞͕ෆఆʹͳΔ͜ͱΛճආ͢ΔͨΊɺϑϨʔϜϫʔΫΫϥε
    ʹΧςΰϦΛఆٛͯ͠ϝιουΛ௥Ճ ͢Δࡍ͸ɺ໊લʹϓϨ
    ϑΟοΫεΛ͚ͭΔΑ͏ʹ͢ΔͱΑ͍Ͱ͠ΐ͏ɻ”

    View Slide

  28. App Library
    methodA methodA
    ͲͪΒͷmethodAͷ࣮૷͕࣮ߦ͞ΕΔͷ͔ෆఆ

    View Slide

  29. App Library
    methodA ish_methodA

    View Slide

  30. 1.1.3.ఆ਺ͷ໋໊نଇ

    View Slide

  31. ✓ ؔ࿈͢ΔΫϥε໊Λ಄ʹ͚ͭΔ
    extern NSString *const ISHObjectGlobalConstant;
    !
    @interface ISHObject : NSObject
    !
    @end
    ISHObject.h
    ISHObject.m
    NSString *const ISHObjectGlobalConstant = @"Foo";
    !
    @implementation ISHObject
    !
    @end

    View Slide

  32. ✓ ֎෦͔Βෆཁͳఆ਺͸ඇެ։ʹ͢Δ
    ISHObject.m
    static NSString *const ISHLocalConstant = @"Foo";
    !
    @implementation ISHObject
    !
    @end

    View Slide

  33. 1.1.4.Α͋͘ΔγϯϘϧͷিಥ

    View Slide

  34. ϥΠϒϥϦ͕ґଘ͢ΔϥΠϒϥϦ͕2ॏʹϏϧυλʔήοτʹ௥Ճ͞Ε͍ͯΔ
    Library A Library B
    Library C Library C

    View Slide

  35. ϥΠϒϥϦ͕ϥΠϒϥϦʹґଘ͢Δ͜ͱѱ͍͜ͱͰ͸
    ͳ͍͕ɺར༻ଆͰিಥ͕ى͖ͳ͍Α͏ʹཹҙ͢Δ΂͖

    View Slide

  36. ✓ ֎෦ͷϥΠϒϥϦʹґଘ͢Δ͜ͱΛ໌ه͢Δ
    ✓ CocoaPodsͳͲͷґଘ؅ཧΛਪ঑͢Δ

    View Slide

  37. View Slide

  38. 1.1.Ϧιʔεͷিಥ

    View Slide

  39. ద౰ʹϥΠϒϥϦͷϦιʔεΛѻ͏ͱ
    ར༻͢ΔΞϓϦͷϦιʔεͱিಥ͢Δ

    View Slide

  40. [UIImage imageNamed:@"Foo"];
    NSLocalizedString(@"Foo", nil);

    View Slide

  41. NSBundle *bundle = [NSBundle mainBundle];
    NSString *filePath = [bundle pathForResource:@"foo" ofType:@"png"];
    [UIImage imageWithContentsOfFile:filePath];
    NSBundle *bundle = [NSBundle mainBundle];
    [bundle localizedStringForKey:@"foo" value:@"" table:nil];
    ϝΠϯόϯυϧͷϦιʔεΛಡΜͰ͍Δ

    View Slide

  42. main bundle
    foo.png foo.png
    foo.png͸main bundleʹ1ݸ͔͠ଘࡏͰ͖ͳ͍
    ?
    App Library

    View Slide

  43. Main bundle
    foo.png
    foo.png
    ϥΠϒϥϦ༻ʹbundleΛͭ͘Ε͹ղܾ
    Library bundle

    View Slide

  44. ✓ ϝΠϯόϯυϧʹΞΫηε͢Δ΋ͷʹ஫ҙ
    ✓ Ϧιʔε͸ϥΠϒϥϦઐ༻ͷNSBundleʹೖΕΔ

    View Slide

  45. View Slide

  46. 2.ྑ͍ @Interface

    View Slide

  47. ✓ Θ͔Γ΍͍͢

    View Slide

  48. ✓ ࣮૷ΛਪଌͰ͖Δ
    ✓ ޡ༻Λͤ͞ͳ͍

    View Slide

  49. @interface ISHCache : NSObject
    !
    @property (nonatomic) NSUInteger size;
    @property (nonatomic) NSUInteger limit;
    !
    - (id)get:(id)key;
    - (void)set:(id)object key:(id)key;
    - (void)remove:(id)key;
    - (void)removeAll;
    !
    @end

    View Slide

  50. @interface ISHCache : NSObject
    !
    @property (nonatomic, readonly) NSUInteger currentSize;
    @property (nonatomic, readwrite) NSUInteger sizeLimit;
    !
    - (id)objectForKey:(id)key;
    - (void)setObject:(id)object forKey:(id)key;
    - (void)removeObjectForKey:(id)key;
    - (void)removeAllObjects;
    !
    @end

    View Slide

  51. ✓ ྑ͍ @property
    ✓ ྑ͍௨஌ύλʔϯ
    τϐοΫ͸ແݶ͋Δ͕ಛʹॏཁͳ2ͭ

    View Slide

  52. 2.1.ྑ͍ @property

    View Slide

  53. ✓ มߋͷՄ൱Λ໌֬ʹ͢Δ
    ✓ ϥΠϒϥϦͷར༻ʹඞཁͳ৘ใ͸༩͑Δ
    ✓ ϥΠϒϥϦͷར༻ʹෆཁͳ৘ใΛ༩͑ͳ͍

    View Slide

  54. 1.1.3.readwrite vs readonly

    View Slide

  55. readwrite
    ✓ มߋ͢Δඞཁ͕͋ΔϓϩύςΟ

    View Slide

  56. readwrite
    ͍͔ͳΔλΠϛϯάʹมߋ͞Εͯ΋
    ΦϒδΣΫτͷ੔߹ੑΛอͯΔ͜ͱ͕๬·͍͠

    View Slide


  57. View Slide

  58. @interface ISHCache : NSObject
    !
    @property (nonatomic, readonly) NSUInteger currentSize;
    @property (nonatomic, readwrite) NSUInteger sizeLimit;
    !
    - (id)objectForKey:(id)key;
    - (void)setObject:(id)object forKey:(id)key;
    - (void)removeObjectForKey:(id)key;
    - (void)removeAllObjects;
    !
    @end
    currentSize < sizeLimit

    View Slide

  59. - (void)setSizeLimit:(NSUInteger)sizeLimit
    {
    _sizeLimit = sizeLimit;
    !
    if (self.currentSize > sizeLimit) {
    [self removeAllObjects];
    }
    }
    currentSize < sizeLimit ΛอͭͨΊʹ͜ͷΑ͏ͳ࣮૷͕ظ଴͞ΕΔ
    NSCache͸͜͏͍͏ڍಈʹͳ͍ͬͯΔ

    View Slide

  60. readwrite
    ͍͔ͳΔλΠϛϯάʹมߋ͞Εͯ΋
    ΦϒδΣΫτͷ੔߹ੑΛอͯΔ͜ͱ͕๬·͍͠

    View Slide

  61. ͜͏͍࣮ͬͨ૷͕໘౗Ͱɺ
    ͦ΋ͦ΋มߋ͢Δඞཁ΋ͳ͍৔߹͸?

    View Slide

  62. readonly
    ✓ มߋ͢Δඞཁ͕ͳ͍ϓϩύςΟ
    ✓ มߋΛېࢭ͍ͨ͠ϓϩύςΟ

    View Slide

  63. readonly
    มߋΛؾʹ͠ͳͯ͘ࡁΉ

    View Slide


  64. View Slide

  65. @interface ISHCache : NSObject
    !
    @property (nonatomic, readonly) NSUInteger currentSize;
    @property (nonatomic, readonly) NSUInteger sizeLimit;
    !
    - (instancetype)initWithSizeLimit:(NSUInteger)sizeLimit;
    !
    - (id)objectForKey:(id)key;
    - (void)setObject:(id)object forKey:(id)key;
    - (void)removeObjectForKey:(id)key;
    - (void)removeAllObjects;
    !
    @end

    View Slide

  66. - (instancetype)initWithSizeLimit:(NSUInteger)sizeLimit
    {
    self = [super init];
    if (self) {
    _sizeLimit = sizeLimit;
    }
    return self;
    }
    มߋͰ͖ͳ͍୅ΘΓʹॳظԽ࣌ʹ஋Λ౉͢

    View Slide

  67. ·ͱΊΔͱ

    View Slide

  68. readwrite
    ✓ มߋ͢Δඞཁ͕͋ΔϓϩύςΟ
    ✓ มߋ͞Εͯ΋੔߹ੑ͕อͨΕΔ
    readonly
    ✓ มߋ͢Δඞཁ͕ͳ͍ϓϩύςΟ
    ✓ มߋΛېࢭ͍ͨ͠ϓϩύςΟ

    View Slide

  69. View Slide

  70. 2.2.ྑ͍௨஌ύλʔϯ

    View Slide

  71. ✓ blocks
    ✓ delegate
    ✓ NSNotification
    ✓ KVO

    View Slide

  72. 2.2.1.blocks

    View Slide

  73. ✓ ௨஌͕ಛఆͷϝιουʹ݁ͼͭ͘
    ✓ ௨஌ͷछྨ͕গͳ͍৔߹
    ద͍ͯ͠Δέʔε
    UIDocument *document;
    [document openWithCompletionHandler:^(BOOL success) {
    // completed
    }];

    View Slide

  74. ✓ Ҿ਺ʹ͸݁ՌΛ౉͢
    ✓ Τϥʔ͕૝ఆ͞ΕΔ৔߹͸NSError΋౉͢
    ࡞๏
    GKTurnBasedMatch *match;
    [match acceptInviteWithCompletionHandler:^(GKTurnBasedMatch *match, NSError *error) {
    ;
    }];

    View Slide

  75. blocksͷߏจ͸ҟ༷ʹෳࡶ

    View Slide

  76. View Slide

  77. ✓ http://fuckingblocksyntax.com
    ✓ Ѫ͕͋Ε͹໰୊ͳ͍

    View Slide

  78. 2.2.2.delegate

    View Slide

  79. ✓ ௨஌͕ಛఆͷΦϒδΣΫτʹ݁ͼͭ͘
    ✓ ௨஌ͷछྨ͕ଟ͍
    ✓ ௨஌ͷड͚ख͕1͔ͭ͠ͳ͍
    ద͍ͯ͠Δέʔε
    @optional
    !
    - (void)scrollViewDidScroll:(UIScrollView *)scrollView;
    - (void)scrollViewDidZoom:(UIScrollView *)scrollView;
    - (void)scrollViewWillBeginDragging:(UIScrollView *)scrollView;
    - (void)scrollViewWillBeginDecelerating:(UIScrollView *)scrollView;
    ໋໊نଇʹ͍ͭͯ͸Cocoa޲͚ίʔσΟϯάΨΠυϥΠϯ, p.15Λࢀর

    View Slide

  80. 2.2.3.NSNotification

    View Slide

  81. ✓ ௨஌ͷड͚ख͕ଟ͍
    ✓ ௨஌ͷૹ৴ݩͱड͚ख͕ԕ͍ͱ͖
    ద͍ͯ͠Δέʔε
    άϩʔόϧͳ௨஌ʹͳΔͷͰ҆қʹ࠾༻ͤͣɺ
    ઌʹdelegate, BlocksͰ࣮ݱͰ͖ͳ͍͔ݕ౼͢Δɻ

    View Slide

  82. 2.3.ྑ͍@interface·ͱΊ

    View Slide

  83. ✓ దࡐదॴ
    readwrite
    readonly
    ✓ blocks
    ✓ delegate
    ✓ NSNotification
    ✓ KVO

    View Slide

  84. View Slide

  85. 3.Ϣχοτςετ

    View Slide

  86. 3.1.ςετΛॻ͘ཧ༝

    View Slide

  87. ςετΛॻ͍ͨํ͕։ൃ͕଎͍Օॴ͕͋Δ
    (σϞΞϓϦͰσόοά͢ΔΑΓ΋)

    View Slide

  88. @interface ISHCache : NSObject
    !
    @property (nonatomic, readonly) NSUInteger currentSize;
    @property (nonatomic, readwrite) NSUInteger sizeLimit;
    !
    - (id)objectForKey:(id)key;
    - (void)setObject:(id)object forKey:(id)key;
    - (void)removeObjectForKey:(id)key;
    - (void)removeAllObjects;
    !
    @end

    View Slide

  89. - (void)testSetObjectForKey
    {
    id object = [[NSObject alloc] init];
    id key = @"foo";
    !
    [cache setObject:object forKey:key];
    !
    XCTAssertEqual(cache.currentSize, 1U);
    XCTAssertEqualObjects([cache objectForKey:key], object);
    }

    View Slide

  90. ✓ setObject:forKey:ͷ࣮ߦ࣌ʹsizeLimitΛ௒͑Δ৔߹͸ʁ
    ✓ setObject:forKey:ͷ࣮ߦޙʹsizeLimitΛখͨ͘͞͠৔߹͸ʁ
    ✓ removeAllObjectsͷ࣮ߦޙͷcurrentSize͸ʁ
    ͱ͍͏৚݅ΛσϞΞϓϦ্Ͱຖճσόοά͢Δ͸ඇৗʹͭΒ͍͕ɺ
    Ϣχοτςετ͸1౓ॻ͚͹܁Γฦ࣮͠ߦͰ͖Δɻ

    View Slide

  91. ίʔυ͕յΕ͍ͯΔ͜ͱΛ͙͢ʹൃݟͰ͖Δ
    ௕ظʹΘͨͬͯෳ਺ਓ͕ϝϯςφϯε͢ΔϓϩάϥϜ͸յΕ΍͍͢
    ςετ͸ϓϩάϥϜ͕ਖ਼͍͜͠ͱͷূ໌Ͱ͸ͳ͍

    View Slide

  92. ✓ setObject:forKey:ͷ࣮ߦ࣌ʹsizeLimitΛ௒͑Δ৔߹͸ʁ
    ✓ setObject:forKey:ͷ࣮ߦޙʹsizeLimitΛখͨ͘͞͠৔߹͸ʁ
    ✓ removeAllObjectsͷ࣮ߦޙͷcurrentSize͸ʁ
    ͲΕ͔1͚ͭͩյΕͨ͜ͱΛσϞΞϓϦ্Ͱ
    ݕ஌͢Δ͜ͱ͸೉͍͕͠ɺϢχοτςετͳΒ؆୯

    View Slide

  93. ϥΠϒϥϦͷςετͷϝϦοτ͸
    ίετʹݟ߹͏͜ͱ͕ଟ͍
    ΞϓϦͱൺ΂ͯ࢓༷มߋ͕͘͢ͳ͍ͷͰɺ
    ςετίʔυ͕ΰϛʹͳΔ֬཰͕௿͍

    View Slide

  94. ϥΠϒϥϦʹର͢ΔϢχοτςετΛॻ͘ཧ༝͸े෼

    View Slide

  95. 3.2.CIΛಋೖ͢Δ

    View Slide

  96. ͔ͤͬ͘ςετΛॻ͍ͨͷͰ࣮֬ʹ࣮ߦ͍ͨ͠
    git pushͷલʹඞͣςετΛ࣮ߦͰ͖Δਓؒ͸গͳ͍

    View Slide

  97. Git repository CI server
    Developer
    git push git hook
    Build report
    CI

    View Slide

  98. git push͢Δͱ΋Εͳ͘Ϩϙʔτ͕΋Β͑Δ࢓૊Έ
    ✓ ϏϧυͰ͖Δ͔ʁ
    ✓ ςετ͸௨͔ͬͨʁ
    ✓ ίʔυΧόϨοδ͸ʁ

    View Slide

  99. 3.2.1.CIͷηοτΞοϓ

    View Slide

  100. ࠷୹ϧʔτ: λʔϛφϧ͔ΒϏϧυͰ͖ΔΑ͏ʹ

    View Slide

  101. xcodebuild clean test \
    -sdk iphonesimulator \
    -workspace ISDiskCache.xcworkspace \
    -scheme ISDiskCache \
    -configuration Debug \
    -destination "name=iPhone Retina (4-inch),OS=7.0"
    ཁ͢ΔʹΫϦʔϯͯ͠ςετͯ͠ͶͬͯίϚϯυ
    ͋ͱ͸͜ΕΛCIαʔόʔʹ఻͑Δ͚ͩͰOK

    View Slide

  102. 3.2.2.WebαʔϏε

    View Slide

  103. CI αʔϏε

    View Slide

  104. Git repository CI server
    Developer
    git push git hook
    Build report

    View Slide

  105. GitHub
    Developer
    git push git hook
    Build report

    View Slide

  106. ✓ public repository͸ແྉ
    ✓ GitHub࿈ܞ
    ✓ status badge

    View Slide

  107. ֘౰ίϛοτͷϏϧυͷঢ়ଶ͕Θ͔Δ !!!

    View Slide

  108. ίʔυΧόϨοδදࣔαʔϏε

    View Slide

  109. ֘౰ίϛοτͷίʔυΧόϨοδ͕Θ͔Δ

    View Slide

  110. GitHub
    Developer
    git push git hook
    Build report
    Coverage report

    View Slide

  111. ✓ public repository͸ແྉ
    ✓ GitHub࿈ܞ
    ✓ status badge

    View Slide

  112. ྆ํηοτΞοϓ͢Δͱ͜Μͳײ͡

    View Slide

  113. https://github.com/ishkawa/ISDiskCache/

    View Slide

  114. 3.3.Ϣχοτςετ·ͱΊ

    View Slide

  115. ✓ ςετͷಋೖͰ։ൃ͕଎͘ͳΔՕॴ΋͋Δ
    ✓ յΕͨՕॴΛൃݟ͠΍͘͢ͳΔ
    ✓ ϥΠϒϥϦͷςετ͸ΞϓϦͷςετΑΓߴCP
    ✓ CIͰৗʹςετ͞Εͨঢ়ଶΛอͭ͜ͱ͕Ͱ͖Δ

    View Slide

  116. View Slide

  117. ·ͱΊ

    View Slide

  118. 1.ಋೖઌͷΞϓϦͱͷিಥʹؾΛ͚ͭΔ
    2.ଞਓʹΘ͔Γ΍͍͢ΠϯλʔϑΣʔεʹ͢Δ
    3.඼࣭͕མͪʹ͍͘࢓૊ΈΛಋೖ͢Δ
    ϥΠϒϥϦΛެ։͢Δͱ͖͸….

    View Slide