Kingfisher ダウンロード - Kingfisher ソースコードのダウンロード

カワセミ

その他のソースコード

ve Photo

ダウンロード

Kingfisher は、Web から画像をダウンロードしてキャッシュするための強力な純粋な Swift ライブラリです。これにより、純粋な Swift の方法を使用して、次のアプリでリモート画像を操作できるようになります。

特徴

カワセミ 101

最も単純な使用例は、 UIImageView拡張機能を使用して画像を画像ビューに設定することです。

 import Kingfisherlet url = URL(文字列: "https://example.com/image.png")imageView.kf.setImage(with: url)

Kingfisher は、 urlから画像をダウンロードし、メモリキャッシュとディスクキャッシュの両方に送信し、 imageViewに表示します。後から同じURLで設定すると、画像がキャッシュから取得されてすぐに表示されます。

SwiftUI を使用している場合にも機能します。

 var body: some View {KFImage(URL(string: "https://example.com/image.png")!)}

より高度な例

強力なオプションを使用すると、Kingfisher で難しいタスクを簡単な方法で実行できます。たとえば、以下のコード:

高解像度の画像をダウンロードします。
画像ビューのサイズに合わせてダウンサンプリングします。
指定された半径で角を丸くします。
ダウンロード中にシステムインジケーターとプレースホルダー画像を表示します。
準備が完了すると、小さなサムネイル画像が「フェードイン」効果でアニメーション化されます。
元の大きな画像も後で使用できるようにディスクにキャッシュされ、詳細表示で再度ダウンロードする必要がなくなります。
タスクが完了すると、成功または失敗にかかわらず、コンソールログが出力されます。

 let url = URL(string: "https://example.com/high_resolution_image.png")letprocessor = DownsamplingImageProcessor(size: imageView.bounds.size) |> RoundCornerImageProcessor(cornerRadius: 20)imageView.kf.indicatorType = .activity
imageView.kf.setImage(with: url,placeholder: UIImage(named: "placeholderImage"),options: [.processor(プロセッサ),.scaleFactor(UIScreen.main.scale),.transition(.fade(1)), .cacheOriginalImage]){result inswitch result {case .success(let value):print("次のタスクが完了しました: (value.source.url?.absoluteString ?? "")")case .failure(let error):print("ジョブが失敗しました: (error.localizedDescription)")}}

日常の仕事でよく遭遇する状況です。カワセミなしで何行書く必要があるかを考えてください。

メソッドチェーン

kf拡張機能のファンではない場合は、 KFビルダーを使用してメソッド呼び出しを連鎖することもできます。以下のコードは同じことを行っています。

 // `kf` を使用します extensionimageView.kf.setImage(with: url,placeholder: placeholderImage,options: [.processor(processor),.loadDiskFileSynchronously,.cacheOriginalImage,.transition(.fade(0.25)),.lowDataMode(.network) (lowResolutionURL))],progressBlock: {receivedSize, totalSize in// 進行状況が更新されました},completionHandler: { result in// Done})// `KF` を使用します builderKF.url(url)
  .placeholder(placeholderImage)
  .setProcessor(プロセッサ)
  .loadDiskFileSynchronously()
  .cacheMemoryOnly()
  .fade(持続時間: 0.25)
  .lowDataModeSource(.network(lowResolutionURL))
  .onProgress { 受信サイズ、合計サイズ }
  .onSuccess {結果は }
  .onFailure { エラー }
  .set(to:imageView)

さらに良いことに、後で SwiftUI に切り替えたい場合は、上記のKF KFImageに変更するだけで完了です。

 struct ContentView: View {var body: some View {KFImage.url(url) .placeholder(placeholderImage) .setProcessor(processor) .loadDiskFileSynchronously() .cacheMemoryOnly() .fade(duration: 0.25) .lowDataModeSource(.network(lowResolutionURL) ) .onProgress { 受信サイズ、合計サイズ } .onSuccess { 結果は } .onFailure { エラーは }}}

要件

カワセミ 8.0

(UIKit/AppKit) iOS 13.0以降 / macOS 10.15以降 / tvOS 13.0以降 / watchOS 6.0以降 /visionOS 1.0以降
(SwiftUI) iOS 14.0以降 / macOS 11.0以降 / tvOS 14.0以降 / watchOS 7.0以降 /visionOS 1.0以降
スイフト 5.9+

カワセミ 7.0

(UIKit/AppKit) iOS 12.0以降 / macOS 10.14以降 / tvOS 12.0以降 / watchOS 5.0以降 /visionOS 1.0以降
(SwiftUI) iOS 14.0以降 / macOS 11.0以降 / tvOS 14.0以降 / watchOS 7.0以降 /visionOS 1.0以降
スイフト5.0以上

インストール

フレームワークをインストールして使用するには、次のいずれかのチュートリアルを参照してください。

UIKit チュートリアル
SwiftUI チュートリアル

あるいは、以下のいずれかの方法に従うこともできます。

Swiftパッケージマネージャー

[ファイル] > [Swift パッケージ] > [パッケージの依存関係の追加]
https://github.com/onevcat/Kingfisher.gitを追加
「次のメジャーまで」を「8.0.0」で選択します。

ココアポッド

ソース 'https://github.com/CocoaPods/Specs.git'プラットフォーム:ios、'13.0'use_frameworks!ターゲット 'MyApp' do
  ポッド 'Kingfisher'、'~> 8.0'end

事前構築されたフレームワーク

リリースページを開き、アセットセクションから Kingfisher の最新バージョンをダウンロードします。
Kingfisher.xcframeworkプロジェクトにドラッグし、ターゲット (通常はアプリのターゲット) に追加します。
ターゲットを選択し、「全般」タブで「フレームワーク、ライブラリ、埋め込みコンテンツ」セクションを見つけ、 Embed Without Signingを Kingfisher に設定します。

ドキュメント

ドキュメントとチュートリアルを確認してください。

ドキュメントホーム
はじめる

UIKit チュートリアル
SwiftUI チュートリアル

一般的なタスク - 全般

一般的なタスク - キャッシュ
一般的なタスク - ダウンローダー
一般的なタスク - プロセッサー

移行中

Kingfisher 8.0 の移行
Kingfisher 7.0 の移行

それより前のバージョンを使用している場合は、以下のガイドを参照して移行手順を確認してください。

他の

カワセミの未来

Kingfisherを軽量化したい。このフレームワークは、画像のダウンロードとキャッシュのためのシンプルなソリューションを提供することに重点を置いています。これは、フレームワークを改善できないという意味ではありません。 Kingfisher は完璧には程遠いため、より良いものにするために必要かつ有用なアップデートが行われる予定です。

開発とテスト

貢献およびプルリクエストは大歓迎です。ただし、一部の機能の実装を計画したり、不確実な問題を解決しようとする前に、まずディスカッションを開くことをお勧めします。プルリクエストがすべてのテストをグリーンにしてビルドできると幸いです。 :)

ロゴについて

Kingfisher のロゴは、中国の 7 つの平面形状からなる解剖パズル、タングラム (七巧板) からインスピレーションを得ています。私は彼女はアマツバメではなくカワセミだと信じていますが、誰かが彼女をハトだと主張しています。彼女に名前を付けるべきだと思います。こんにちは、皆さん、何か提案はありますか？

接触

Twitter または Sina Weibo で私をフォローしてご連絡ください。問題が見つかった場合は、チケットを開きます。プルリクエストも大歓迎です。

後援者とスポンサー

オープンソースプロジェクトは、皆さんの助けがなければ長く存続することはできません。 Kingfisher が役立つと思われる場合は、スポンサーになってこのプロジェクトを支援することをご検討ください。あなたのユーザーアイコンまたは会社のロゴが、あなたのホームページへのリンクとともに私のブログに表示されます。

GitHub Sponsors を通じてスポンサーになります。 ❤️

特別な感謝: