Files
gh-sjungling-claude-plugins…/skills/ios-swift-expert/references/apple-guidelines.md
2025-11-30 08:57:43 +08:00

56 lines
1.6 KiB
Markdown

# Apple Guidelines & Resources
Authoritative sources for iOS and macOS development best practices.
## Official Documentation
- **Apple Developer Documentation**: https://developer.apple.com/documentation/
- **Swift Language Guide**: https://docs.swift.org/swift-book/
- **Human Interface Guidelines**: https://developer.apple.com/design/human-interface-guidelines/
- **Swift API Design Guidelines**: https://www.swift.org/documentation/api-design-guidelines/
- **WWDC Videos**: https://developer.apple.com/videos/
## Human Interface Guidelines
Follow platform conventions for:
- Navigation patterns and controls
- Interactions and gestures
- Dynamic Type for accessibility
- Privacy preferences handling
- Multitasking and background modes
## Swift API Design Guidelines
Key principles:
- Clarity at the point of use
- Naming that makes code read like prose
- Prefer methods and properties over free functions
- Omit needless words
- Compensate for weak type information
## Privacy & Security
Best practices:
- Request permissions with clear purpose strings
- Handle user data securely (Keychain for credentials)
- Use App Transport Security (HTTPS by default)
- Implement Face ID/Touch ID for sensitive operations
- Follow privacy manifests requirements (iOS 17+)
## Accessibility
Requirements:
- Add accessibility labels and hints
- Support VoiceOver navigation
- Test with Accessibility Inspector
- Support Dynamic Type and larger text sizes
- Ensure sufficient color contrast
## Localization
Guidelines:
- Use `NSLocalizedString` for user-facing text
- Support right-to-left languages
- Externalize date/number formatting
- Test with pseudo-localization