質問をすることでしか得られない、回答やアドバイスがある。

15分調べてもわからないことは、質問しよう!

ただいまの
回答率

87.49%

自社サービスで外部デベロッパー向けにSDKを作りたい

受付中

回答 3

投稿

  • 評価
  • クリップ 2
  • VIEW 1,648

score 172

現在、rubyを用いたwebサービスを運用しております。(iosのアプリ版もあります。)

そして、最近、外部のデベロッパー向けにSDKを作ろうという話になっております。

しかし、お恥ずかしいところ、社内メンバーの中には他社のSDKを使ったことがある人はいても、
作ったことがある人がおらず、話が止まっております。

勉強のためにもSDKを作ろうという話にはなっておりますので、この度、質問に至りました。

大まかで構いませんので、どのような手順でやっていければよいのか、ご教示願えますでしょうか?
(参考URL、調べるべきキーワード等ありますと助かります。)

「SDK 作成」等で検索しても外部SDKを使用した開発の記事ばかりで検討違いのものばかりでてしまいます・・・。


SDKは
・ruby
・swift、ios

向けにまずは作りたく、ゆくゆくは他言語でも対応できるようにしていきたいです。

宜しくお願いします。
  • 気になる質問をクリップする

    クリップした質問は、後からいつでもマイページで確認できます。

    またクリップした質問に回答があった際、通知やメールを受け取ることができます。

    クリップを取り消します

  • 良い質問の評価を上げる

    以下のような質問は評価を上げましょう

    • 質問内容が明確
    • 自分も答えを知りたい
    • 質問者以外のユーザにも役立つ

    評価が高い質問は、TOPページの「注目」タブのフィードに表示されやすくなります。

    質問の評価を上げたことを取り消します

  • 評価を下げられる数の上限に達しました

    評価を下げることができません

    • 1日5回まで評価を下げられます
    • 1日に1ユーザに対して2回まで評価を下げられます

    質問の評価を下げる

    teratailでは下記のような質問を「具体的に困っていることがない質問」、「サイトポリシーに違反する質問」と定義し、推奨していません。

    • プログラミングに関係のない質問
    • やってほしいことだけを記載した丸投げの質問
    • 問題・課題が含まれていない質問
    • 意図的に内容が抹消された質問
    • 過去に投稿した質問と同じ内容の質問
    • 広告と受け取られるような投稿

    評価が下がると、TOPページの「アクティブ」「注目」タブのフィードに表示されにくくなります。

    質問の評価を下げたことを取り消します

    この機能は開放されていません

    評価を下げる条件を満たしてません

    評価を下げる理由を選択してください

    詳細な説明はこちら

    上記に当てはまらず、質問内容が明確になっていない質問には「情報の追加・修正依頼」機能からコメントをしてください。

    質問の評価を下げる機能の利用条件

    この機能を利用するためには、以下の事項を行う必要があります。

質問への追記・修正、ベストアンサー選択の依頼

  • Stripe

    2015/08/01 22:45

    Webサービスの運用と、SDKを作ることと、どう繋がるんですか?

    キャンセル

  • kento2543

    2015/08/01 23:52

    現在、リリースはすんで、運用フェーズにあります。
    そして機能追加としてSDKを作りたいという話になっております。

    運用をしていく中で外部デベロッパーにも使用してほしいという話になったためです。

    説明不足で申し訳ありません。

    キャンセル

回答 3

+1

それは、SDKというよりは、Web APIを利用するためのライブラリですよね?

iOSのアプリ版もあって、すでに運用フェーズに入っているなら、そのライブラリは既にほぼ完成していることになります。
例えば、そのiOS版のライブラリを作りたいなら、既に完成しているそのアプリからWeb APIを利用する部分の抜き出して整理すれば、ライブラリが完成します。

投稿

  • 回答の評価を上げる

    以下のような回答は評価を上げましょう

    • 正しい回答
    • わかりやすい回答
    • ためになる回答

    評価が高い回答ほどページの上位に表示されます。

  • 回答の評価を下げる

    下記のような回答は推奨されていません。

    • 間違っている回答
    • 質問の回答になっていない投稿
    • スパムや攻撃的な表現を用いた投稿

    評価を下げる際はその理由を明確に伝え、適切な回答に修正してもらいましょう。

0

Swift/iOSのSDK開発についてお答えさせて頂きます
まずiOS(or Mac)にフォーカスを当てたSDK開発の場合は配布方法をどうするかで選択肢が変わってくるのですが、今だとCocoaPodsかCarthageのメジャー配布方法に合わせた形で開発するのが良いかと思われます

CocoaPods

iOS向けのライブラリをCocoaPodsで配布する
自前のライブラリをCocoaPodsで管理するメモ

Carthage

Carthageの配布の仕方(すっごい簡単!)


これらの配布方法は混在させることもできるので特に手間じゃなければ両方対応してしまうのがbetterですね

Rubyの方は自分は良く分からないのですがgemを配布する形になるんですかね?
なのでRuby gemの公開方法だったりでググってみると色々見つかるかもしれませんね

RubyGem

RubyGemはめっちゃ簡単に作れる!

投稿

編集

  • 回答の評価を上げる

    以下のような回答は評価を上げましょう

    • 正しい回答
    • わかりやすい回答
    • ためになる回答

    評価が高い回答ほどページの上位に表示されます。

  • 回答の評価を下げる

    下記のような回答は推奨されていません。

    • 間違っている回答
    • 質問の回答になっていない投稿
    • スパムや攻撃的な表現を用いた投稿

    評価を下げる際はその理由を明確に伝え、適切な回答に修正してもらいましょう。

  • 2015/08/01 23:54

    詳しく有り難うございます。
    rubyの場合ですと、gemを入れるだけでSDK使えるサービスってありますね。

    大変参考になりました。

    キャンセル

0

調べるべきキーワード
SDK以外では、「API」の設計がキーワードだと思います。
APIが窓口だとすると、そこに申請するための用紙がSDKだからです。


参考URL
Twitter Developers
Evernote Developers
マイポケットデベロッパーポータル
Amazon.co.jp: Web API: The Good Parts(本)

上3つはAPIとSDKを公開しているサービスです。
一番下はWeb APIの設計に関する書籍です。
直接SDKの作り方ではないですが、参考にはなると思います。


大まかで構いませんので、どのような手順でやっていければよいのか

1. アプリ本体を作る
2. APIを整理する
3. SDKを作る
4. 内部調整
5. 公開

(これは単純化したイメージで、実際は前後するでしょう)


2は、APIとドキュメントだけ提供する形も取れますし、
APIとSDKの作成は対にして進めていきます。

3でのSDKの作成自体は、社内の開発環境の整備の延長線上(にあるべき)です。
独自ライブラリを作る先にAPIがあり、ミドルツールを作る先にSDKがあります。

逆にSDKだからといって、今までとぜんぜん違うものを作ろうとしてしまうと、
二度手間です。しかも公開以後はアプリ本体の更新に追従する必要があります。


社内用ツールと勝手が違うところは、なるべくソースを隠蔽するところです。
APIを叩くのと同じで、ツールを叩くだけとか、インターフェイスだけ見せます。

もうひとつ違うのは、属人性を排除して、ドキュメントやツールに置きかえるところです。
たとえばAさんしか上手く動かせないのは、公開後は単なる不具合になってしまいます。

そこで4では、外部から募集するなどして、
APIやSDKの内部構造を知らない開発者たちに、
クローズドな環境で試験的に使わせてみます。


5の公開場所については、今ならGitHubも有力かもしれません。
RubyのGemでも良いですが、多言語展開なら本拠地向きでしょう。
その場合、オープンソースにするかどうかもひとつの選択肢です。

投稿

  • 回答の評価を上げる

    以下のような回答は評価を上げましょう

    • 正しい回答
    • わかりやすい回答
    • ためになる回答

    評価が高い回答ほどページの上位に表示されます。

  • 回答の評価を下げる

    下記のような回答は推奨されていません。

    • 間違っている回答
    • 質問の回答になっていない投稿
    • スパムや攻撃的な表現を用いた投稿

    評価を下げる際はその理由を明確に伝え、適切な回答に修正してもらいましょう。

15分調べてもわからないことは、teratailで質問しよう!

  • ただいまの回答率 87.49%
  • 質問をまとめることで、思考を整理して素早く解決
  • テンプレート機能で、簡単に質問をまとめられる

関連した質問

同じタグがついた質問を見る