CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Documentation

You can find the complete documentation for this project in the docs/ directory. It describes the architecture, build system, development practices and more in detail the the project.

There is also a minimal, LLM-friendly version of the documentation in README-LLM.md. You can refer to the file if you need a quick overview of the project without going through the entire documentation.

Build and Development Commands

Primary Build System

This project uses Fastlane for primary build automation. Key commands:

# Install dependencies
bundle install

# Run all tests across platforms (iOS, macOS, tvOS, watchOS)
bundle exec fastlane tests

# Run specific platform tests
bundle exec fastlane test destination:"platform=iOS Simulator,name=iPhone 16"

# Build for specific platform
bundle exec fastlane build destination:"platform=iOS Simulator,name=iPhone 16"

# Lint CocoaPods spec and Swift Package Manager
bundle exec fastlane lint

Release Process

# Full release workflow (tests, linting, versioning, GitHub release, CocoaPods push)
bundle exec fastlane release version:X.X.X

Architecture Overview

@docs/architecture.md

Kingfisher is a modular image loading and caching library with clear separation of concerns:

Core Components Flow

KingfisherManager (Sources/General/KingfisherManager.swift) - Central coordinator
ImageDownloader (Sources/Networking/ImageDownloader.swift) - Network layer
ImageCache (Sources/Cache/ImageCache.swift) - Dual-layer caching (memory + disk)
ImageProcessor (Sources/Image/ImageProcessor.swift) - Image transformation pipeline

Key Architectural Patterns

Protocol-oriented design with KingfisherCompatible protocol
Namespace wrapper pattern - All functionality accessed via .kf property
Builder pattern - KF.url()... method chaining
Options pattern - KingfisherOptionsInfo for configuration

Module Structure

Sources/
├── General/           # Core managers, options, data providers
├── Networking/        # Download, prefetch, session management  
├── Cache/            # Multi-layer caching system
├── Image/            # Processing, filters, formats, transitions
├── Extensions/       # UIKit/AppKit/SwiftUI integration
├── SwiftUI/         # SwiftUI-specific components
├── Utility/         # Helper utilities and extensions
└── Views/           # Custom UI components

Integration Points

UIKit: Extensions for UIImageView, UIButton via .kf namespace
SwiftUI: KFImage and KFAnimatedImage components
Cross-platform: Extensive conditional compilation for iOS/macOS/tvOS/watchOS/visionOS

Platform Support

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+
Swift: 5.9+ (with Swift 6 strict concurrency support)

Testing

Test Structure

Location: Tests/KingfisherTests/
Framework: XCTest with custom KingfisherTestHelper
Network mocking: Uses Nocilla dependency for HTTP stubbing
Test assets: dancing-banana.gif, single-frame.gif

Running Tests

# All platforms (preferred)
bundle exec fastlane tests

# Single platform via destination
bundle exec fastlane test destination:"platform=iOS Simulator,name=iPhone 15"

Documentation System

Provides a DocC-based documentation for framework users:

DocC integration with comprehensive tutorials and API docs
Location: Sources/Documentation.docc/
Online: Swift Package Index hosted documentation
Tutorials: Both UIKit and SwiftUI getting started guides available

AGENTS.md 3.8 KB История Исходник