デビッド ebbo




サンプルパッケージと次のレベルにNuGetを取ります NuGetは大幅にあなたのプロジェクトに. NETライブラリを取得するプロセスを簡素化しました。 どのようなエラーが発生しやすく、痛みを伴うプロセスであるように使用すると、アセンブリ参照を追加するのと同じくらい簡単になっています。 ユーザーがライブラリを使用することを学ぶ助け:それは開発者のワークフローの重要な部分を解決したが、それはまた、パズルの別の重要な部分を解決する可能性を秘めています。 私はこれらのクールなパッケージを見つけましたが、今何? そこ今日NuGetで利用可能なクールなパッケージのトンがあり、その数は毎日増えています。 私はリストを下に移動して、それらを試してみるために彼らのプロジェクトにパッケージのすべての種類をインストールするユーザーの数を聞きました。 あなたはライブラリに慣れていない場合しかし、あなたはそれをどのように始めるのですか? 議論を説明するための例として、オーチャードの人たちによって書かれた気の利いた小さな粘土のパッケージを見てみましょう。 あなたのプロジェクトにそれをインストールしていると言うと、それを使用して起動します。 ここではあなたがかもしれないものです。 NuGetのダイアログを使用すると、「プロジェクトURL」へのリンクを提供します。 典型的には、プロジェクトはCodePlexの/のBitbucket / githubの上でホストされている場所へのリンクだし、実際にこの1はhttp://clay. codeplex. com/が表示されます。 あなたがそこにいるしたら、[ドキュメント]タブをクリックしてみてください。 残念ながら、多くのプロジェクトがあまりありません。 しかし、ここでは、少なくともトピックのバートランドさんのブログ記事へのポインタを持っています。 だから、今、彼のポストに行きます。 あなたはそれを読み、しばらくして、あなたはそれがについて何を知っているし、あなたのコードにそれを使用して起動するのに十分なこまごまとをつなぎ合わせることができます。 私は例として、粘土を取ったが、これはかなり典型的な経験です。 事実は未熟(まだ便利)プロジェクトに関する知識の多く​​は、唯一「ブログ投稿シリーズの中ではなく、正式なドキュメントに存在していることです。 理想的な、それは物事が起こるかだわけではありません。 サンプルパッケージと救助にNuGet 痛みが少なくと正しい道にあなたのユーザーを取得する基本的なサンプルを配布するためにNuGetを使用します。幸いなことに、この問題に対する簡単で効果的な解決策があります。 そこで、この記事を説明するために、私は先に行って、クレイのためにそのようなパッケージを作成した:Clay. Sample。 このパッケージには、それをインストールする(城のように、だけでなく、粘土が依存する他のもの)粘土をインストールするように、クレイに依存します。 それは、独自の任意のバイナリが含まれていないことを意味し、「ソースのみ」のパッケージです。 それでは、先に行くと、ブランドの新しいコンソールアプリでそれを試してみましょう(とクライアント・プロファイルを使用しないように変更)。 NuGetのダイアログ「ライブラリリファレンス追加」をクレイの検索に移動します。 あなたはこれを取得します。 5D. png?imgmax = 800 "/%5B7% あなたはそれをインストールした後、プロジェクトは次のようになります。 5B13%5D. png?imgmax = 800 "/% 城*とlog4netの:まず、あなたは粘土へとその依存関係に期待されるすべての参照を得た方法に注意してください。 しかし、より興味深いのは、それはまた、\サンプルの下ClaySamplesソースファイルに粘土をもたらしました。 それは私が臆面もなくベルトランのポストからコピーされた粘土のサンプル数を、含まれています。 ここでは一例です。 ポストは説明し、すべてを証明する存在では約10ようなサンプルがあります。 今すぐあなたのコンソールメインに移動して、すべてのサンプルを実行するメソッドの呼び出しを行います。 そこには何もありませんがそれはブログ投稿ではありませんが、大きな利点は、あなたは自明NuGet経由でプロジェクトにそれを得ることができるということです、あなたは、直接それらを一緒につなぎすることなく/デバッグにサンプルを実行することができます。 もちろん、ブログの記事(またはドキュメント)はまだ余分な洞察力のための読書価値があるかもしれません。 しかし、あなたはサンプルが今のあなた、あなたが必要とするすべてを与えることを発見し、後でより深い読みを保存することがあります。 パッケージの作成者にコール:サンプルパッケージを書きます! 私はパッケージのこのタイプは、開発者の生産性に大きな影響を与えることができると思います。 しかし、実際に起こること、そのために、それらのパッケージを作成する必要があります! 私は粘土のための1つを作成している間、私はすべてのサンプルパッケージを作成するボランティアわけではない十分なだけでなく、それを知っている誰もが確かにそれをうまく行うことができますがまた:)明らかに、それを行うための最善の人は、パッケージの著者です。 あなたはNuGetパッケージを所有するのであれば、そのタスクに取るようにしてみてください。 それは超簡単だし、ユーザーはそれをあなたに感謝します! 表記、コンベンション、コンベンション 私は最近WebActivatorスタートアップコード用App_Start規則を使用してについてブログとほぼすべてのWebActivatorユーザーは、既存のパッケージがこれを使用するために変換すると、大きな反響を得ました。 ここでの状況は非常に似ている、と私は上記示したものである同様の慣例のために呼び出します。 一言で言えば: あなたのパッケージが何とか命名されている場合は、サンプルパッケージBlah. Sampleを呼び出します。 あなたが複数のサンプルパッケージが必要な場合は、Blah. Sample. SomethingとBlah. Sample. SomethingElseそれらを呼び出すことができます。 何とか上のBlah. Sampleパッケージが依存してください。 そのパッケージ内では、ソースファイルだけが含まれています。 何とか\サンプルの下にそれらのファイルを配置します。 あなたは、一つ以上を持っている、とあなたは意味をなさないと思うものは何でもそれらを呼び出すことができます。 そこに上のコードは、あなた次第ですが、一般的な考え方は、ユーザーが始めるのに役立つだろうと思うものは何でも含まれるようにします。 あまりにも多くの余分な設定なしで、サン​​プルコードを簡単に実行可能にするために試してみてください。 これは、いくつかのパッケージのために困難であるが、あなたのベストを尽くすこと:) パッケージの作成 例として、粘土を取って、ここnupkgにそれらを包装する前にファイルの構造は次のとおりです。 だから、ちょうど2つのファイル、nuspecと、前処理サンプルファイルがあります。 ここnuspecは、次のとおりです。 ここで興味深い部分は、パッケージID、説明、および粘土への依存性があります。