thebushidocollective/han/publishing-workflow

# Register your email
pod trunk register email@example.com 'Your Name'
 
# Verify email (check inbox for verification link)
# Click link in email to activate account

# Verify registration
pod trunk me
 
# Sample output:
# - Name:     Your Name
# - Email:    email@example.com
# - Since:    January 1st, 2024
# - Pods:     None

Pod::Spec.new do |spec|
  # Semantic versioning: MAJOR.MINOR.PATCH
  spec.version = '1.0.0'
 
  # Must match git tag
  spec.source = {
    :git => 'https://github.com/username/MyLibrary.git',
    :tag => spec.version.to_s
  }
end

Pod::Spec.new do |spec|
  # Identity (required)
  spec.name         = 'MyLibrary'
  spec.version      = '1.0.0'
 
  # Description (required)
  spec.summary      = 'Brief one-line description'
  spec.description  = 'Longer description with more details about what the library does'
 
  # Links (required)
  spec.homepage     = 'https://github.com/username/MyLibrary'
  spec.source       = { :git => 'https://github.com/username/MyLibrary.git', :tag => spec.version.to_s }
 
  # License (required)
  spec.license      = { :type => 'MIT', :file => 'LICENSE' }
 
  # Authors (required)
  spec.authors      = { 'Your Name' => 'email@example.com' }
 
  # Platform (required)
  spec.ios.deployment_target = '13.0'
end

# Fast validation (skips build)
pod lib lint --quick
 
# Check for common issues without full build

# Complete validation with build
pod lib lint
 
# With Swift version
pod lib lint --swift-version=5.9
 
# Verbose output
pod lib lint --verbose

# Allow warnings (not recommended for new pods)
pod lib lint --allow-warnings
 
# Better: Fix warnings
pod lib lint
# Address each warning individually

# Validate podspec for publishing
pod spec lint
 
# Validates against remote repository
# Simulates real-world installation

# Stage all changes
git add .
 
# Commit changes
git commit -m "Release version 1.0.0"
 
# Create tag matching podspec version
git tag 1.0.0
 
# Push to remote with tags
git push origin main --tags

# Semantic versioning
git tag 1.0.0      # MAJOR.MINOR.PATCH
git tag 1.0.0-beta.1  # Pre-release
git tag 1.0.0-rc.1    # Release candidate
 
# Must match spec.version in podspec

# Push to CocoaPods Trunk
pod trunk push MyLibrary.podspec
 
# With specific Swift version
pod trunk push MyLibrary.podspec --swift-version=5.9
 
# Allow warnings (not recommended)
pod trunk push MyLibrary.podspec --allow-warnings

Validating podspec
 -> MyLibrary (1.0.0)
 
Updating spec repo `trunk`
 -> MyLibrary (1.0.0)
 
--------------------------------------------------------------------------------
 🎉  Congrats
 
 🚀  MyLibrary (1.0.0) successfully published
 📅  January 1st, 2024
 🌎  https://cocoapods.org/pods/MyLibrary
 👍  Tell your friends!
--------------------------------------------------------------------------------

# In podspec
spec.version = '1.0.1'  # Was 1.0.0

# Git workflow
git add .
git commit -m "Fix: Resolve crash in background mode"
git tag 1.0.1
git push origin main --tags
pod trunk push MyLibrary.podspec

# In podspec
spec.version = '1.1.0'  # Was 1.0.1

# Git workflow
git add .
git commit -m "Add: Support for custom themes"
git tag 1.1.0
git push origin main --tags
pod trunk push MyLibrary.podspec

# In podspec
spec.version = '2.0.0'  # Was 1.1.0

# Git workflow
git add .
git commit -m "BREAKING: Refactor API for modern Swift"
git tag 2.0.0
git push origin main --tags
pod trunk push MyLibrary.podspec

# View all your published pods
pod trunk me
 
# Shows:
# - Pods:
#   - MyLibrary
#   - MyOtherLibrary

# Add team member to pod
pod trunk add-owner MyLibrary email@example.com
 
# Remove contributor
pod trunk remove-owner MyLibrary email@example.com

# Deprecate specific version
pod trunk deprecate MyLibrary --version=1.0.0
 
# Deprecate entire pod
pod trunk deprecate MyLibrary

# In podspec
spec.deprecated = true
spec.deprecated_in_favor_of = 'NewAwesomeLibrary'

ERROR | [MyLibrary] The repo has no tag for version 1.0.0

# Create and push tag
git tag 1.0.0
git push origin --tags

ERROR | [MyLibrary] xcodebuild: Returned an unsuccessful exit code

# Run detailed validation
pod lib lint --verbose
 
# Fix errors shown in output
# Re-validate until clean

ERROR | [MyLibrary] Missing required attribute `license`

# Add to podspec
spec.license = { :type => 'MIT', :file => 'LICENSE' }

# Create LICENSE file in repo root

# 1. Test in example app
cd Example
pod install
# Run app, verify functionality
 
# 2. Test in real project
# Create test project, add pod from local path
pod 'MyLibrary', :path => '../MyLibrary'
 
# 3. Validate
pod lib lint
pod spec lint

# Follow semantic versioning strictly
spec.version = '1.0.0'  # Initial release
spec.version = '1.0.1'  # Bug fix
spec.version = '1.1.0'  # New feature
spec.version = '2.0.0'  # Breaking change

# Changelog
 
## [1.1.0] - 2024-01-15
### Added
-Custom theme support
-Dark mode compatibility
 
### Fixed
-Memory leak in background processing
 
## [1.0.0] - 2024-01-01
-Initial release

# MyLibrary
 
Brief description of library.
 
## Installation
 
\`\`\`ruby
pod 'MyLibrary', '~> 1.0'
\`\`\`
 
## Usage
 
\`\`\`swift
import MyLibrary
 
let library = MyLibrary()
library.doSomething()
\`\`\`
 
## Requirements
 
-iOS 13.0+
-Swift 5.7+
 
## License
 
MyLibrary is available under the MIT license.

pod trunk push --skip-tests  # Risky

pod trunk push --allow-warnings  # Fix warnings instead

# Missing git tag - publish will fail
pod trunk push

# Still version 1.0.0 after changes - confusing
spec.version = '1.0.0'

pod lib lint
pod spec lint
# Test in real project

pod lib lint
# Address warnings

git tag 1.0.0
git push --tags

spec.version = '1.0.1'  # Incremented

# 1. Prepare podspec
vim MyLibrary.podspec
# Update version to 1.0.0
 
# 2. Update CHANGELOG
vim CHANGELOG.md
# Document changes
 
# 3. Commit and tag
git add .
git commit -m "Release 1.0.0: Initial public release"
git tag 1.0.0
git push origin main --tags
 
# 4. Validate locally
pod lib lint
 
# 5. Validate for publishing
pod spec lint
 
# 6. Publish
pod trunk push MyLibrary.podspec
 
# 7. Verify
pod search MyLibrary
# Should show your new pod