发布1.0.0版本:保留最新代码
531
.gitignore
vendored
Normal file
@@ -0,0 +1,531 @@
|
||||
# Xcode
|
||||
#
|
||||
# gitignore contributors: remember to update Global/Xcode.gitignore, Objective-C.gitignore & Swift.gitignore
|
||||
|
||||
## User settings
|
||||
xcuserdata/
|
||||
|
||||
## compatibility with Xcode 8 and earlier (ignoring not required starting Xcode 9)
|
||||
*.xcscmblueprint
|
||||
*.xccheckout
|
||||
|
||||
## compatibility with Xcode 3 and earlier (ignoring not required starting Xcode 4)
|
||||
build/
|
||||
DerivedData/
|
||||
*.moved-aside
|
||||
*.pbxuser
|
||||
!default.pbxuser
|
||||
*.mode1v3
|
||||
!default.mode1v3
|
||||
*.mode2v3
|
||||
!default.mode2v3
|
||||
*.perspectivev3
|
||||
!default.perspectivev3
|
||||
|
||||
## Obj-C/Swift specific
|
||||
*.hmap
|
||||
|
||||
## App packaging
|
||||
*.ipa
|
||||
*.dSYM.zip
|
||||
*.dSYM
|
||||
|
||||
## Playgrounds
|
||||
timeline.xctimeline
|
||||
playground.xcworkspace
|
||||
|
||||
# Swift Package Manager
|
||||
#
|
||||
# Add this line if you want to avoid checking in source code from Swift Package Manager dependencies.
|
||||
# Packages/
|
||||
# Package.pins
|
||||
# Package.resolved
|
||||
# *.xcodeproj
|
||||
#
|
||||
# Xcode automatically generates this directory with a .xcworkspacedata file and xcuserdata
|
||||
# hence it is not needed unless you have added a package configuration file to your project
|
||||
.swiftpm/
|
||||
|
||||
.build/
|
||||
|
||||
# CocoaPods
|
||||
#
|
||||
# We recommend against adding the Pods directory to your .gitignore. However
|
||||
# you should judge for yourself, the pros and cons are mentioned at:
|
||||
# https://guides.cocoapods.org/using/using-cocoapods.html#should-i-check-the-pods-directory-into-source-control
|
||||
#
|
||||
# Pods/
|
||||
#
|
||||
# Add this line if you want to avoid checking in source code from the Xcode workspace
|
||||
# *.xcworkspace
|
||||
|
||||
# Carthage
|
||||
#
|
||||
# Add this line if you want to avoid checking in source code from Carthage dependencies.
|
||||
# Carthage/Checkouts
|
||||
|
||||
Carthage/Build/
|
||||
|
||||
# Accio dependency management
|
||||
Dependencies/
|
||||
.accio/
|
||||
|
||||
# fastlane
|
||||
#
|
||||
# It is recommended to not store the screenshots in the git repo. Instead, use fastlane
|
||||
# to re-generate the screenshots whenever they are needed.
|
||||
# For more information about the recommended setup visit:
|
||||
# https://docs.fastlane.tools/best-practices/source-control/
|
||||
|
||||
fastlane/report.xml
|
||||
fastlane/Preview.html
|
||||
fastlane/screenshots/**/*.png
|
||||
fastlane/test_output
|
||||
|
||||
# Code Injection
|
||||
#
|
||||
# After new code Injection tools there's a generated folder /iOSInjectionProject
|
||||
# https://github.com/johnno1962/injectionforxcode
|
||||
|
||||
iOSInjectionProject/
|
||||
|
||||
# macOS
|
||||
#
|
||||
# macOS system files
|
||||
.DS_Store
|
||||
.AppleDouble
|
||||
.LSOverride
|
||||
|
||||
# Icon must end with two \r
|
||||
Icon
|
||||
|
||||
# Thumbnails
|
||||
._*
|
||||
|
||||
# Files that might appear in the root of a volume
|
||||
.DocumentRevisions-V100
|
||||
.fseventsd
|
||||
.Spotlight-V100
|
||||
.TemporaryItems
|
||||
.Trashes
|
||||
.VolumeIcon.icns
|
||||
.com.apple.timemachine.donotpresent
|
||||
|
||||
# Directories potentially created on remote AFP share
|
||||
.AppleDB
|
||||
.AppleDesktop
|
||||
Network Trash Folder
|
||||
Temporary Items
|
||||
.apdisk
|
||||
|
||||
# Xcode Patch
|
||||
*.xcodeproj/*
|
||||
!*.xcodeproj/project.pbxproj
|
||||
!*.xcodeproj/xcshareddata/
|
||||
!*.xcodeproj/project.xcworkspace/
|
||||
*.xcodeproj/project.xcworkspace/*
|
||||
!*.xcodeproj/project.xcworkspace/contents.xcworkspacedata
|
||||
!*.xcodeproj/project.xcworkspace/xcuserdata/
|
||||
|
||||
# Bundle artifacts
|
||||
*.xcarchive
|
||||
|
||||
# CocoaPods artifacts
|
||||
Pods/
|
||||
|
||||
# Carthage artifacts
|
||||
Carthage/Build/
|
||||
|
||||
# AppCode specific files
|
||||
.idea/
|
||||
|
||||
# VSCode specific files
|
||||
.vscode/
|
||||
*.code-workspace
|
||||
|
||||
# Temporary files
|
||||
*~
|
||||
.tmp/
|
||||
*.tmp
|
||||
*.swp
|
||||
*.swo
|
||||
|
||||
# Log files
|
||||
*.log
|
||||
|
||||
# Local configuration files
|
||||
.env
|
||||
.env.local
|
||||
.env.*.local
|
||||
|
||||
# Backup files
|
||||
*.bak
|
||||
*.backup
|
||||
*.orig
|
||||
|
||||
# Generated files
|
||||
*.generated.swift
|
||||
*.generated.h
|
||||
|
||||
# Documentation build
|
||||
docs/build/
|
||||
|
||||
# Profiling data
|
||||
*.profraw
|
||||
*.profdata
|
||||
|
||||
# Test artifacts
|
||||
*.gcov
|
||||
*.gcda
|
||||
*.gcno
|
||||
|
||||
# Localization
|
||||
*.strings.bak
|
||||
|
||||
# Asset catalogs generated images
|
||||
*.xcassets/*/*_generated/
|
||||
|
||||
# Interface Builder files
|
||||
*.storyboard.bak
|
||||
*.xib.bak
|
||||
|
||||
# Core Data models
|
||||
*.xcdatamodeld/.xcdatamodel/contents
|
||||
|
||||
# Swift Package Manager build artifacts
|
||||
.build/
|
||||
.swiftpm/xcode/
|
||||
|
||||
# SwiftLint
|
||||
*.swiftlint.yml
|
||||
|
||||
# SwiftFormat
|
||||
.swiftformat
|
||||
|
||||
# Tuist
|
||||
Tuist/Generated/
|
||||
Tuist/Derived/
|
||||
|
||||
# Xcode Server
|
||||
.xcsync
|
||||
|
||||
# Bazel
|
||||
bazel-*
|
||||
WORKSPACE.bak
|
||||
BUILD.bak
|
||||
|
||||
# Buck
|
||||
buck-out/
|
||||
\.buckd/
|
||||
*.keystore
|
||||
!debug.keystore
|
||||
|
||||
# Backup files for iOS and macOS projects
|
||||
*.mobileprovision
|
||||
*.p12
|
||||
*.cer
|
||||
*.keychain
|
||||
|
||||
# Firebase
|
||||
google-services.json
|
||||
GoogleService-Info.plist
|
||||
|
||||
# Localization build outputs
|
||||
*.lproj/*.strings.bak
|
||||
|
||||
# TestFlight
|
||||
TestFlightDistribution/
|
||||
|
||||
# App Store Connect
|
||||
appstore-connect-metadata/
|
||||
|
||||
# Crashlytics
|
||||
fabric.properties
|
||||
|
||||
# Sentry
|
||||
sentry.properties
|
||||
|
||||
# New Relic
|
||||
newrelic.properties
|
||||
|
||||
# Analytics
|
||||
analytics.properties
|
||||
|
||||
# AdMob
|
||||
admob-config.json
|
||||
|
||||
# In-app purchases
|
||||
receipt-validation-data/
|
||||
|
||||
# Auto-generated documentation
|
||||
docs/API/
|
||||
|
||||
# API keys and secrets
|
||||
*.pem
|
||||
*.key
|
||||
*.crt
|
||||
secrets.plist
|
||||
APIKeys.plist
|
||||
|
||||
# Local development overrides
|
||||
Config.local.plist
|
||||
Settings.local.plist
|
||||
|
||||
# Build outputs
|
||||
build/
|
||||
dist/
|
||||
out/
|
||||
|
||||
# Temporary Xcode files
|
||||
*.xcscheme.bak
|
||||
*.xcconfig.bak
|
||||
|
||||
# Simulator data
|
||||
*.app.dSYM
|
||||
*.app.xcarchive
|
||||
|
||||
# Performance testing results
|
||||
*.perf
|
||||
*.performance
|
||||
|
||||
# Memory testing
|
||||
*.leaks
|
||||
*.heap
|
||||
|
||||
# Coverage reports
|
||||
coverage/
|
||||
*.lcov
|
||||
|
||||
# Dependency cache
|
||||
Carthage/Checkouts/
|
||||
Pods/.local/
|
||||
.swift-package-manager
|
||||
|
||||
# IDE temp files
|
||||
.vscode/
|
||||
.fleet/
|
||||
.nova/
|
||||
|
||||
# macOS app bundles
|
||||
*.app/Contents/_CodeSignature/
|
||||
*.app/Contents/CodeResources
|
||||
*.app/Contents/embedded.provisionprofile
|
||||
|
||||
# Sparkle update framework
|
||||
Sparkle.framework/
|
||||
|
||||
# MAS (Mac App Store) sandboxing
|
||||
*.app/Contents/Resources/entitlements.mas.plist
|
||||
|
||||
# Development builds
|
||||
*-Dev.app
|
||||
*-Debug.app
|
||||
*-Beta.app
|
||||
|
||||
# Archive directories
|
||||
archives/
|
||||
Archives/
|
||||
|
||||
# Distribution certificates
|
||||
distribution.cer
|
||||
distribution.p12
|
||||
|
||||
# Development certificates
|
||||
development.cer
|
||||
development.p12
|
||||
|
||||
# Push notification certificates
|
||||
apns.cer
|
||||
apns.p12
|
||||
apns-key.p12
|
||||
|
||||
# Universal Links configuration
|
||||
apple-app-site-association
|
||||
|
||||
# App Store screenshots
|
||||
screenshots/
|
||||
marketing-materials/
|
||||
|
||||
# Beta testing
|
||||
TestFlight/
|
||||
Crashlytics/
|
||||
|
||||
# Project-specific ignores for BTC Price Monitor
|
||||
|
||||
# API response cache
|
||||
api-cache/
|
||||
price-cache.json
|
||||
|
||||
# User preferences and settings
|
||||
user-preferences.plist
|
||||
settings.json
|
||||
|
||||
# Log files specific to price monitoring
|
||||
price-fetch.log
|
||||
network-errors.log
|
||||
debug-log.txt
|
||||
|
||||
# Temporary data files
|
||||
temp-prices.json
|
||||
backup-data.json
|
||||
|
||||
# Configuration overrides
|
||||
config-dev.plist
|
||||
config-local.plist
|
||||
config-production.plist.bak
|
||||
|
||||
# Development certificates and provisioning profiles (sensitive)
|
||||
*.mobileprovision
|
||||
*.p12
|
||||
*.cer
|
||||
*.keychain
|
||||
|
||||
# Build artifacts specific to macOS
|
||||
*.app.dSYM
|
||||
*.app.xcarchive
|
||||
Release/
|
||||
Debug/
|
||||
|
||||
# Xcode derived data (beyond standard)
|
||||
DerivedData-*/
|
||||
xcuserdata/
|
||||
|
||||
# Test data and mock responses
|
||||
test-responses/
|
||||
mock-api-data.json
|
||||
|
||||
# Performance monitoring
|
||||
performance-data/
|
||||
memory-usage.json
|
||||
network-stats.json
|
||||
|
||||
# Documentation build artifacts
|
||||
docs/build/
|
||||
docs/output/
|
||||
|
||||
# Local development environment
|
||||
.env.local
|
||||
.dev.env
|
||||
.local.env
|
||||
|
||||
# IDE specific files (additional)
|
||||
.fleet/
|
||||
.nova/
|
||||
.cursor/
|
||||
|
||||
# Backup and temporary files
|
||||
*.backup
|
||||
*.bak
|
||||
*.tmp
|
||||
*~
|
||||
.#*
|
||||
\#*#
|
||||
.*.swp
|
||||
.*.swo
|
||||
|
||||
# Lock files (keep package-lock.json but ignore others)
|
||||
*.lock
|
||||
Package.lock
|
||||
|
||||
# Dependency manager artifacts
|
||||
spm-build/
|
||||
swift-package-manager/
|
||||
|
||||
# Localization and internationalization
|
||||
*.lproj/Localizable.strings.bak
|
||||
*.strings.tmp
|
||||
|
||||
# Asset generation
|
||||
*.xcassets/Assets.car
|
||||
*.xcassets/*.imageset/*.png
|
||||
|
||||
# Build tools
|
||||
fastlane/report.xml
|
||||
fastlane/Preview.html
|
||||
fastlane/screenshots/
|
||||
fastlane/test_output/
|
||||
|
||||
# Code signing and distribution
|
||||
distribution/
|
||||
build-for-testing/
|
||||
app-store-release/
|
||||
|
||||
# Development and debugging
|
||||
*.xcdebug
|
||||
*.xctrace
|
||||
*.trace
|
||||
|
||||
# Simulator data
|
||||
*.app.dSYM/
|
||||
*.app.xcarchive/
|
||||
|
||||
# Testing
|
||||
*.gcov
|
||||
*.gcda
|
||||
*.gcno
|
||||
coverage/
|
||||
test-results/
|
||||
junit.xml
|
||||
|
||||
# Documentation
|
||||
docs/_build/
|
||||
docs/.doctrees/
|
||||
|
||||
# Local configuration
|
||||
Config.xcconfig.local
|
||||
Settings.xcconfig.local
|
||||
|
||||
# Secrets and sensitive data
|
||||
secrets/
|
||||
api-keys.plist
|
||||
credentials.plist
|
||||
|
||||
# Temporary network data
|
||||
network-cache/
|
||||
api-cache.json
|
||||
response-cache/
|
||||
|
||||
# Application data (for development)
|
||||
user-data/
|
||||
preferences-dev.plist
|
||||
app-state.json
|
||||
|
||||
# Backup files for configuration
|
||||
config-backup/
|
||||
settings-backup/
|
||||
|
||||
# Development logs
|
||||
debug-logs/
|
||||
development-logs/
|
||||
error-logs/
|
||||
|
||||
# Performance profiling
|
||||
*.trace
|
||||
*.prof
|
||||
*.xcactivitylog
|
||||
|
||||
# Build system cache
|
||||
build-cache/
|
||||
compile-cache/
|
||||
linker-cache/
|
||||
|
||||
# Version control hooks (keep the hooks themselves)
|
||||
.git/hooks/*.sample
|
||||
.git/hooks/*.rej
|
||||
|
||||
# Local development scripts
|
||||
scripts/dev-*
|
||||
scripts/local-*
|
||||
scripts/temp-*
|
||||
|
||||
# Temporary build artifacts
|
||||
temp-build/
|
||||
build-temp/
|
||||
tmp-build/
|
||||
|
||||
# Asset processing
|
||||
assets/temp/
|
||||
assets/cache/
|
||||
assets/.DS_Store
|
||||
|
||||
CLAUDE.md
|
||||
326
Bitcoin Monitoring.xcodeproj/project.pbxproj
Normal file
@@ -0,0 +1,326 @@
|
||||
// !$*UTF8*$!
|
||||
{
|
||||
archiveVersion = 1;
|
||||
classes = {
|
||||
};
|
||||
objectVersion = 77;
|
||||
objects = {
|
||||
|
||||
/* Begin PBXFileReference section */
|
||||
4E9410702EB09F90003658CB /* Bitcoin Monitoring.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = "Bitcoin Monitoring.app"; sourceTree = BUILT_PRODUCTS_DIR; };
|
||||
/* End PBXFileReference section */
|
||||
|
||||
/* Begin PBXFileSystemSynchronizedRootGroup section */
|
||||
4E9410722EB09F90003658CB /* test1 */ = {
|
||||
isa = PBXFileSystemSynchronizedRootGroup;
|
||||
path = test1;
|
||||
sourceTree = "<group>";
|
||||
};
|
||||
/* End PBXFileSystemSynchronizedRootGroup section */
|
||||
|
||||
/* Begin PBXFrameworksBuildPhase section */
|
||||
4E94106D2EB09F90003658CB /* Frameworks */ = {
|
||||
isa = PBXFrameworksBuildPhase;
|
||||
buildActionMask = 2147483647;
|
||||
files = (
|
||||
);
|
||||
runOnlyForDeploymentPostprocessing = 0;
|
||||
};
|
||||
/* End PBXFrameworksBuildPhase section */
|
||||
|
||||
/* Begin PBXGroup section */
|
||||
4E9410672EB09F90003658CB = {
|
||||
isa = PBXGroup;
|
||||
children = (
|
||||
4E9410722EB09F90003658CB /* test1 */,
|
||||
4E9410712EB09F90003658CB /* Products */,
|
||||
);
|
||||
sourceTree = "<group>";
|
||||
};
|
||||
4E9410712EB09F90003658CB /* Products */ = {
|
||||
isa = PBXGroup;
|
||||
children = (
|
||||
4E9410702EB09F90003658CB /* Bitcoin Monitoring.app */,
|
||||
);
|
||||
name = Products;
|
||||
sourceTree = "<group>";
|
||||
};
|
||||
/* End PBXGroup section */
|
||||
|
||||
/* Begin PBXNativeTarget section */
|
||||
4E94106F2EB09F90003658CB /* Bitcoin Monitoring */ = {
|
||||
isa = PBXNativeTarget;
|
||||
buildConfigurationList = 4E94107F2EB09F92003658CB /* Build configuration list for PBXNativeTarget "Bitcoin Monitoring" */;
|
||||
buildPhases = (
|
||||
4E94106C2EB09F90003658CB /* Sources */,
|
||||
4E94106D2EB09F90003658CB /* Frameworks */,
|
||||
4E94106E2EB09F90003658CB /* Resources */,
|
||||
);
|
||||
buildRules = (
|
||||
);
|
||||
dependencies = (
|
||||
);
|
||||
fileSystemSynchronizedGroups = (
|
||||
4E9410722EB09F90003658CB /* test1 */,
|
||||
);
|
||||
name = "Bitcoin Monitoring";
|
||||
packageProductDependencies = (
|
||||
);
|
||||
productName = test1;
|
||||
productReference = 4E9410702EB09F90003658CB /* Bitcoin Monitoring.app */;
|
||||
productType = "com.apple.product-type.application";
|
||||
};
|
||||
/* End PBXNativeTarget section */
|
||||
|
||||
/* Begin PBXProject section */
|
||||
4E9410682EB09F90003658CB /* Project object */ = {
|
||||
isa = PBXProject;
|
||||
attributes = {
|
||||
BuildIndependentTargetsInParallel = 1;
|
||||
LastSwiftUpdateCheck = 1620;
|
||||
LastUpgradeCheck = 1620;
|
||||
TargetAttributes = {
|
||||
4E94106F2EB09F90003658CB = {
|
||||
CreatedOnToolsVersion = 16.2;
|
||||
};
|
||||
};
|
||||
};
|
||||
buildConfigurationList = 4E94106B2EB09F90003658CB /* Build configuration list for PBXProject "Bitcoin Monitoring" */;
|
||||
developmentRegion = en;
|
||||
hasScannedForEncodings = 0;
|
||||
knownRegions = (
|
||||
en,
|
||||
Base,
|
||||
);
|
||||
mainGroup = 4E9410672EB09F90003658CB;
|
||||
minimizedProjectReferenceProxies = 1;
|
||||
preferredProjectObjectVersion = 77;
|
||||
productRefGroup = 4E9410712EB09F90003658CB /* Products */;
|
||||
projectDirPath = "";
|
||||
projectRoot = "";
|
||||
targets = (
|
||||
4E94106F2EB09F90003658CB /* Bitcoin Monitoring */,
|
||||
);
|
||||
};
|
||||
/* End PBXProject section */
|
||||
|
||||
/* Begin PBXResourcesBuildPhase section */
|
||||
4E94106E2EB09F90003658CB /* Resources */ = {
|
||||
isa = PBXResourcesBuildPhase;
|
||||
buildActionMask = 2147483647;
|
||||
files = (
|
||||
);
|
||||
runOnlyForDeploymentPostprocessing = 0;
|
||||
};
|
||||
/* End PBXResourcesBuildPhase section */
|
||||
|
||||
/* Begin PBXSourcesBuildPhase section */
|
||||
4E94106C2EB09F90003658CB /* Sources */ = {
|
||||
isa = PBXSourcesBuildPhase;
|
||||
buildActionMask = 2147483647;
|
||||
files = (
|
||||
);
|
||||
runOnlyForDeploymentPostprocessing = 0;
|
||||
};
|
||||
/* End PBXSourcesBuildPhase section */
|
||||
|
||||
/* Begin XCBuildConfiguration section */
|
||||
4E94107D2EB09F92003658CB /* Debug */ = {
|
||||
isa = XCBuildConfiguration;
|
||||
buildSettings = {
|
||||
ALWAYS_SEARCH_USER_PATHS = NO;
|
||||
ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES;
|
||||
CLANG_ANALYZER_NONNULL = YES;
|
||||
CLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE;
|
||||
CLANG_CXX_LANGUAGE_STANDARD = "gnu++20";
|
||||
CLANG_ENABLE_MODULES = YES;
|
||||
CLANG_ENABLE_OBJC_ARC = YES;
|
||||
CLANG_ENABLE_OBJC_WEAK = YES;
|
||||
CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
|
||||
CLANG_WARN_BOOL_CONVERSION = YES;
|
||||
CLANG_WARN_COMMA = YES;
|
||||
CLANG_WARN_CONSTANT_CONVERSION = YES;
|
||||
CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
|
||||
CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
|
||||
CLANG_WARN_DOCUMENTATION_COMMENTS = YES;
|
||||
CLANG_WARN_EMPTY_BODY = YES;
|
||||
CLANG_WARN_ENUM_CONVERSION = YES;
|
||||
CLANG_WARN_INFINITE_RECURSION = YES;
|
||||
CLANG_WARN_INT_CONVERSION = YES;
|
||||
CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
|
||||
CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;
|
||||
CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
|
||||
CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
|
||||
CLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER = YES;
|
||||
CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
|
||||
CLANG_WARN_STRICT_PROTOTYPES = YES;
|
||||
CLANG_WARN_SUSPICIOUS_MOVE = YES;
|
||||
CLANG_WARN_UNGUARDED_AVAILABILITY = YES_AGGRESSIVE;
|
||||
CLANG_WARN_UNREACHABLE_CODE = YES;
|
||||
CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
|
||||
COPY_PHASE_STRIP = NO;
|
||||
DEBUG_INFORMATION_FORMAT = dwarf;
|
||||
ENABLE_STRICT_OBJC_MSGSEND = YES;
|
||||
ENABLE_TESTABILITY = YES;
|
||||
ENABLE_USER_SCRIPT_SANDBOXING = YES;
|
||||
GCC_C_LANGUAGE_STANDARD = gnu17;
|
||||
GCC_DYNAMIC_NO_PIC = NO;
|
||||
GCC_NO_COMMON_BLOCKS = YES;
|
||||
GCC_OPTIMIZATION_LEVEL = 0;
|
||||
GCC_PREPROCESSOR_DEFINITIONS = (
|
||||
"DEBUG=1",
|
||||
"$(inherited)",
|
||||
);
|
||||
GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
|
||||
GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
|
||||
GCC_WARN_UNDECLARED_SELECTOR = YES;
|
||||
GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
|
||||
GCC_WARN_UNUSED_FUNCTION = YES;
|
||||
GCC_WARN_UNUSED_VARIABLE = YES;
|
||||
LOCALIZATION_PREFERS_STRING_CATALOGS = YES;
|
||||
MACOSX_DEPLOYMENT_TARGET = 14.8;
|
||||
MTL_ENABLE_DEBUG_INFO = INCLUDE_SOURCE;
|
||||
MTL_FAST_MATH = YES;
|
||||
ONLY_ACTIVE_ARCH = YES;
|
||||
SDKROOT = macosx;
|
||||
SWIFT_ACTIVE_COMPILATION_CONDITIONS = "DEBUG $(inherited)";
|
||||
SWIFT_OPTIMIZATION_LEVEL = "-Onone";
|
||||
};
|
||||
name = Debug;
|
||||
};
|
||||
4E94107E2EB09F92003658CB /* Release */ = {
|
||||
isa = XCBuildConfiguration;
|
||||
buildSettings = {
|
||||
ALWAYS_SEARCH_USER_PATHS = NO;
|
||||
ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES;
|
||||
CLANG_ANALYZER_NONNULL = YES;
|
||||
CLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE;
|
||||
CLANG_CXX_LANGUAGE_STANDARD = "gnu++20";
|
||||
CLANG_ENABLE_MODULES = YES;
|
||||
CLANG_ENABLE_OBJC_ARC = YES;
|
||||
CLANG_ENABLE_OBJC_WEAK = YES;
|
||||
CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
|
||||
CLANG_WARN_BOOL_CONVERSION = YES;
|
||||
CLANG_WARN_COMMA = YES;
|
||||
CLANG_WARN_CONSTANT_CONVERSION = YES;
|
||||
CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
|
||||
CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
|
||||
CLANG_WARN_DOCUMENTATION_COMMENTS = YES;
|
||||
CLANG_WARN_EMPTY_BODY = YES;
|
||||
CLANG_WARN_ENUM_CONVERSION = YES;
|
||||
CLANG_WARN_INFINITE_RECURSION = YES;
|
||||
CLANG_WARN_INT_CONVERSION = YES;
|
||||
CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
|
||||
CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;
|
||||
CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
|
||||
CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
|
||||
CLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER = YES;
|
||||
CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
|
||||
CLANG_WARN_STRICT_PROTOTYPES = YES;
|
||||
CLANG_WARN_SUSPICIOUS_MOVE = YES;
|
||||
CLANG_WARN_UNGUARDED_AVAILABILITY = YES_AGGRESSIVE;
|
||||
CLANG_WARN_UNREACHABLE_CODE = YES;
|
||||
CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
|
||||
COPY_PHASE_STRIP = NO;
|
||||
DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
|
||||
ENABLE_NS_ASSERTIONS = NO;
|
||||
ENABLE_STRICT_OBJC_MSGSEND = YES;
|
||||
ENABLE_USER_SCRIPT_SANDBOXING = YES;
|
||||
GCC_C_LANGUAGE_STANDARD = gnu17;
|
||||
GCC_NO_COMMON_BLOCKS = YES;
|
||||
GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
|
||||
GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
|
||||
GCC_WARN_UNDECLARED_SELECTOR = YES;
|
||||
GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
|
||||
GCC_WARN_UNUSED_FUNCTION = YES;
|
||||
GCC_WARN_UNUSED_VARIABLE = YES;
|
||||
LOCALIZATION_PREFERS_STRING_CATALOGS = YES;
|
||||
MACOSX_DEPLOYMENT_TARGET = 14.8;
|
||||
MTL_ENABLE_DEBUG_INFO = NO;
|
||||
MTL_FAST_MATH = YES;
|
||||
SDKROOT = macosx;
|
||||
SWIFT_COMPILATION_MODE = wholemodule;
|
||||
};
|
||||
name = Release;
|
||||
};
|
||||
4E9410802EB09F92003658CB /* Debug */ = {
|
||||
isa = XCBuildConfiguration;
|
||||
buildSettings = {
|
||||
ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
|
||||
ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor;
|
||||
ASSETCATALOG_COMPILER_INCLUDE_ALL_APPICON_ASSETS = YES;
|
||||
CODE_SIGN_ENTITLEMENTS = test1/test1.entitlements;
|
||||
CODE_SIGN_STYLE = Automatic;
|
||||
COMBINE_HIDPI_IMAGES = YES;
|
||||
CURRENT_PROJECT_VERSION = 1;
|
||||
DEVELOPMENT_ASSET_PATHS = "\"test1/Preview Content\"";
|
||||
ENABLE_PREVIEWS = YES;
|
||||
GENERATE_INFOPLIST_FILE = YES;
|
||||
INFOPLIST_KEY_LSApplicationCategoryType = "public.app-category.finance";
|
||||
INFOPLIST_KEY_NSHumanReadableCopyright = "";
|
||||
LD_RUNPATH_SEARCH_PATHS = (
|
||||
"$(inherited)",
|
||||
"@executable_path/../Frameworks",
|
||||
);
|
||||
MACOSX_DEPLOYMENT_TARGET = 12.4;
|
||||
MARKETING_VERSION = 1.0;
|
||||
PRODUCT_BUNDLE_IDENTIFIER = com.mark.test1;
|
||||
PRODUCT_NAME = "$(TARGET_NAME)";
|
||||
SWIFT_EMIT_LOC_STRINGS = YES;
|
||||
SWIFT_VERSION = 5.0;
|
||||
};
|
||||
name = Debug;
|
||||
};
|
||||
4E9410812EB09F92003658CB /* Release */ = {
|
||||
isa = XCBuildConfiguration;
|
||||
buildSettings = {
|
||||
ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
|
||||
ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor;
|
||||
ASSETCATALOG_COMPILER_INCLUDE_ALL_APPICON_ASSETS = YES;
|
||||
CODE_SIGN_ENTITLEMENTS = test1/test1.entitlements;
|
||||
CODE_SIGN_STYLE = Automatic;
|
||||
COMBINE_HIDPI_IMAGES = YES;
|
||||
CURRENT_PROJECT_VERSION = 1;
|
||||
DEVELOPMENT_ASSET_PATHS = "\"test1/Preview Content\"";
|
||||
ENABLE_PREVIEWS = YES;
|
||||
GENERATE_INFOPLIST_FILE = YES;
|
||||
INFOPLIST_KEY_LSApplicationCategoryType = "public.app-category.finance";
|
||||
INFOPLIST_KEY_NSHumanReadableCopyright = "";
|
||||
LD_RUNPATH_SEARCH_PATHS = (
|
||||
"$(inherited)",
|
||||
"@executable_path/../Frameworks",
|
||||
);
|
||||
MACOSX_DEPLOYMENT_TARGET = 12.4;
|
||||
MARKETING_VERSION = 1.0;
|
||||
PRODUCT_BUNDLE_IDENTIFIER = com.mark.test1;
|
||||
PRODUCT_NAME = "$(TARGET_NAME)";
|
||||
SWIFT_EMIT_LOC_STRINGS = YES;
|
||||
SWIFT_VERSION = 5.0;
|
||||
};
|
||||
name = Release;
|
||||
};
|
||||
/* End XCBuildConfiguration section */
|
||||
|
||||
/* Begin XCConfigurationList section */
|
||||
4E94106B2EB09F90003658CB /* Build configuration list for PBXProject "Bitcoin Monitoring" */ = {
|
||||
isa = XCConfigurationList;
|
||||
buildConfigurations = (
|
||||
4E94107D2EB09F92003658CB /* Debug */,
|
||||
4E94107E2EB09F92003658CB /* Release */,
|
||||
);
|
||||
defaultConfigurationIsVisible = 0;
|
||||
defaultConfigurationName = Release;
|
||||
};
|
||||
4E94107F2EB09F92003658CB /* Build configuration list for PBXNativeTarget "Bitcoin Monitoring" */ = {
|
||||
isa = XCConfigurationList;
|
||||
buildConfigurations = (
|
||||
4E9410802EB09F92003658CB /* Debug */,
|
||||
4E9410812EB09F92003658CB /* Release */,
|
||||
);
|
||||
defaultConfigurationIsVisible = 0;
|
||||
defaultConfigurationName = Release;
|
||||
};
|
||||
/* End XCConfigurationList section */
|
||||
};
|
||||
rootObject = 4E9410682EB09F90003658CB /* Project object */;
|
||||
}
|
||||
7
Bitcoin Monitoring.xcodeproj/project.xcworkspace/contents.xcworkspacedata
generated
Normal file
@@ -0,0 +1,7 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<Workspace
|
||||
version = "1.0">
|
||||
<FileRef
|
||||
location = "self:">
|
||||
</FileRef>
|
||||
</Workspace>
|
||||
@@ -0,0 +1,14 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
|
||||
<plist version="1.0">
|
||||
<dict>
|
||||
<key>SchemeUserState</key>
|
||||
<dict>
|
||||
<key>test1.xcscheme_^#shared#^_</key>
|
||||
<dict>
|
||||
<key>orderHint</key>
|
||||
<integer>0</integer>
|
||||
</dict>
|
||||
</dict>
|
||||
</dict>
|
||||
</plist>
|
||||
636
LICENSE
Normal file
@@ -0,0 +1,636 @@
|
||||
GNU GENERAL PUBLIC LICENSE
|
||||
Version 3, 29 June 2007
|
||||
|
||||
Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
|
||||
Everyone is permitted to copy and distribute verbatim copies
|
||||
of this license document, but changing it is not allowed.
|
||||
|
||||
Preamble
|
||||
|
||||
The GNU General Public License is a free, copyleft license for
|
||||
software and other kinds of works.
|
||||
|
||||
The licenses for most software and other practical works are designed
|
||||
to take away your freedom to share and change the works. By contrast,
|
||||
the GNU General Public License is intended to guarantee your freedom to
|
||||
share and change all versions of a program--to make sure it remains free
|
||||
software for all its users. We, the Free Software Foundation, use the
|
||||
GNU General Public License for most of our software; it applies also to
|
||||
any other work released this way by its authors. You can apply it to
|
||||
your programs, too.
|
||||
|
||||
When we speak of free software, we are referring to freedom, not
|
||||
price. Our General Public Licenses are designed to make sure that you
|
||||
have the freedom to distribute copies of free software (and charge for
|
||||
them if you wish), that you receive source code or can get it if you
|
||||
want it, that you can change the software or use pieces of it in new
|
||||
free programs, and that you know you can do these things.
|
||||
|
||||
To protect your rights, we need to prevent others from denying you
|
||||
these rights or asking you to surrender the rights. Therefore, you have
|
||||
certain responsibilities if you distribute copies of the software, or if
|
||||
you modify it: responsibilities to respect the freedom of others.
|
||||
|
||||
For example, if you distribute copies of such a program, whether
|
||||
gratis or for a fee, you must pass on to the recipients the same
|
||||
freedoms that you received. You must make sure that they, too, receive
|
||||
or can get the source code. And you must show them these terms so they
|
||||
know their rights.
|
||||
|
||||
Developers that use the GNU GPL protect your rights with two steps:
|
||||
(1) assert copyright on the software, and (2) offer you this License
|
||||
giving you legal permission to copy, distribute and/or modify it.
|
||||
|
||||
For the developers' and authors' protection, the GPL clearly explains
|
||||
that there is no warranty for this free software. For both users' and
|
||||
authors' sake, the GPL requires that modified versions be marked as
|
||||
changed, so that their problems will not be attributed erroneously to
|
||||
authors of previous versions.
|
||||
|
||||
Some devices are designed to deny users access to install or run
|
||||
modified versions of the software inside them, although the manufacturer
|
||||
can do so. This is fundamentally incompatible with the aim of
|
||||
protecting users' freedom to change the software. The systematic
|
||||
pattern of such abuse occurs in the area of products for individuals to
|
||||
use, which is precisely where it is most unacceptable. Therefore, we
|
||||
have designed this version of the GPL to prohibit the practice for those
|
||||
products. If such problems arise substantially in other domains, we
|
||||
stand ready to extend this provision to those domains in future versions
|
||||
of the GPL, as needed to protect the freedom of users.
|
||||
|
||||
Finally, every program is threatened constantly by software patents.
|
||||
States should not allow patents to restrict development and use of
|
||||
software on general-purpose computers, but in those that do, we wish to
|
||||
avoid the special danger that patents applied to a free program could
|
||||
make it effectively proprietary. To prevent this, the GPL assures that
|
||||
patents cannot be used to render the program non-free.
|
||||
|
||||
The precise terms and conditions for copying, distribution and
|
||||
modification follow.
|
||||
|
||||
TERMS AND CONDITIONS
|
||||
|
||||
0. Definitions.
|
||||
|
||||
"This License" refers to version 3 of the GNU General Public License.
|
||||
|
||||
"Copyright" also means copyright-like laws that apply to other kinds of
|
||||
works, such as semiconductor masks.
|
||||
|
||||
"The Program" refers to any copyrightable work licensed under this
|
||||
License. Each licensee is addressed as "you". "Licensees" and
|
||||
"recipients" may be individuals or organizations.
|
||||
|
||||
To "modify" a work means to copy from or adapt all or part of the work
|
||||
in a fashion requiring copyright permission, other than the making of an
|
||||
exact copy. The resulting work is called a "modified version" of the
|
||||
earlier work or a work "based on" the earlier work.
|
||||
|
||||
A "covered work" means either the unmodified Program or a work based
|
||||
on the Program.
|
||||
|
||||
To "propagate" a work means to do anything with it that, without
|
||||
permission, would make you directly or secondarily liable for
|
||||
infringement under applicable copyright law, except executing it on a
|
||||
computer or modifying a private copy. Propagation includes copying,
|
||||
distribution (with or without modification), making available to the
|
||||
public, and in some countries other activities as well.
|
||||
|
||||
To "convey" a work means any kind of propagation that enables other
|
||||
parties to make or receive copies. Mere interaction with a user through
|
||||
a computer network, with no transfer of a copy, is not conveying.
|
||||
|
||||
An interactive user interface displays "Appropriate Legal Notices"
|
||||
to the extent that it includes a convenient and prominently visible
|
||||
feature that (1) displays an appropriate copyright notice, and (2)
|
||||
tells the user that there is no warranty for the work (except to the
|
||||
extent that warranties are provided), that licensees may convey the
|
||||
work under this License, and how to view a copy of this License. If
|
||||
the interface presents a list of user commands or options, such as a
|
||||
menu, a prominent item in the list meets this criterion.
|
||||
|
||||
1. Source Code.
|
||||
|
||||
The "source code" for a work means the preferred form of the work
|
||||
for making modifications to it. "Object code" means any non-source
|
||||
form of a work.
|
||||
|
||||
A "Standard Interface" means an interface that either is an official
|
||||
standard defined by a recognized standards body, or, in the case of
|
||||
interfaces specified for a particular programming language, one that
|
||||
is widely used among developers working in that language.
|
||||
|
||||
The "System Libraries" of an executable work include anything, other
|
||||
than the work as a whole, that (a) is included in the normal form of
|
||||
packaging a Major Component, but which is not part of that Major
|
||||
Component, and (b) serves only to enable use of the work with that
|
||||
Major Component, or to implement a Standard Interface for which an
|
||||
implementation is available to the public in source code form. A
|
||||
"Major Component", in this context, means a major essential component
|
||||
(kernel, window system, and so on) of the specific operating system
|
||||
(if any) on which the executable work runs, or a compiler used to
|
||||
produce the work, or an object code interpreter used to run it.
|
||||
|
||||
The "Corresponding Source" for a work in object code form means all
|
||||
the source code needed to generate, install, and (for an executable
|
||||
work) run the object code and to modify the work, including scripts to
|
||||
control those activities. However, it does not include the work's
|
||||
System Libraries, or general-purpose tools or generally available free
|
||||
programs which are used unmodified in performing those activities but
|
||||
which are not part of the work. For example, Corresponding Source
|
||||
includes interface definition files associated with source files for
|
||||
the work, and the source code for shared libraries and dynamically
|
||||
linked subprograms that the work is specifically designed to require,
|
||||
such as by intimate data communication or control flow between those
|
||||
subprograms and other parts of the work.
|
||||
|
||||
The Corresponding Source need not include anything that users
|
||||
can regenerate automatically from other parts of the Corresponding
|
||||
Source.
|
||||
|
||||
The Corresponding Source for a work in source code form is that
|
||||
same work.
|
||||
|
||||
2. Basic Permissions.
|
||||
|
||||
All rights granted under this License are granted for the term of
|
||||
copyright on the Program, and are irrevocable provided the stated
|
||||
conditions are met. This License explicitly affirms your unlimited
|
||||
permission to run the unmodified Program. The output from running a
|
||||
covered work is covered by this License only if the output, given its
|
||||
content, constitutes a covered work. This License acknowledges your
|
||||
rights of fair use or other equivalent, as provided by copyright law.
|
||||
|
||||
You may make, run and propagate covered works that you do not
|
||||
convey, without conditions so long as your license otherwise remains
|
||||
in force. You may convey covered works to others for the sole purpose
|
||||
of having them make modifications exclusively for you, or provide you
|
||||
with facilities for running those works, provided that you comply with
|
||||
the terms of this License in conveying all material for which you do
|
||||
not control copyright. Those thus making or running the covered works
|
||||
for you must do so exclusively on your behalf, under your direction
|
||||
and control, on terms that prohibit them from making any copies of
|
||||
your copyrighted material outside their relationship with you.
|
||||
|
||||
Conveying under any other circumstances is permitted solely under
|
||||
the conditions stated below. Sublicensing is not allowed; section 10
|
||||
makes it unnecessary.
|
||||
|
||||
3. Protecting Users' Legal Rights From Anti-Circumvention Law.
|
||||
|
||||
No covered work shall be deemed part of an effective technological
|
||||
measure under any applicable law fulfilling obligations under article
|
||||
11 of the WIPO copyright treaty adopted on 20 December 1996, or
|
||||
similar laws prohibiting or restricting circumvention of such
|
||||
measures.
|
||||
|
||||
When you convey a covered work, you waive any legal power to forbid
|
||||
circumvention of technological measures to the extent such circumvention
|
||||
is effected by exercising rights under this License with respect to
|
||||
the covered work, and you disclaim any intention to limit operation or
|
||||
modification of the work as a means of enforcing, against the work's
|
||||
users, your or third parties' legal rights to forbid circumvention of
|
||||
technological measures.
|
||||
|
||||
4. Conveying Verbatim Copies.
|
||||
|
||||
You may convey verbatim copies of the Program's source code as you
|
||||
receive it, in any medium, provided that you conspicuously and
|
||||
appropriately publish on each copy an appropriate copyright notice;
|
||||
keep intact all notices stating that this License and any
|
||||
non-permissive terms added in accord with section 7 apply to the code;
|
||||
keep intact all notices of the absence of any warranty; and give all
|
||||
recipients a copy of this License along with the Program.
|
||||
|
||||
You may charge any price or no price for each copy that you convey,
|
||||
and you may offer support or warranty protection for a fee.
|
||||
|
||||
5. Conveying Modified Source Versions.
|
||||
|
||||
You may convey a work based on the Program, or the modifications to
|
||||
produce it from the Program, in the form of source code under the
|
||||
terms of section 4, provided that you also meet all of these conditions:
|
||||
|
||||
a) The work must carry prominent notices stating that you modified
|
||||
it, and giving a relevant date.
|
||||
|
||||
b) The work must carry prominent notices stating that it is
|
||||
released under this License and any conditions added under section
|
||||
7. This requirement modifies the requirement in section 4 to
|
||||
"keep intact all notices".
|
||||
|
||||
c) You must license the entire work, as a whole, under this
|
||||
License to anyone who comes into possession of a copy. This
|
||||
License will therefore apply, along with any applicable section 7
|
||||
additional terms, to the whole of the work, and all its parts,
|
||||
regardless of how they are packaged. This License gives no
|
||||
permission to license the work in any other way, but it does not
|
||||
invalidate such permission if you have separately received it.
|
||||
|
||||
d) If the work has interactive user interfaces, each must display
|
||||
Appropriate Legal Notices; however, if the Program has interactive
|
||||
interfaces that do not display Appropriate Legal Notices, your
|
||||
work need not make them do so.
|
||||
|
||||
A compilation of a covered work with other separate and independent
|
||||
works, which are not by their nature extensions of the covered work,
|
||||
and which are not combined with it such as to form a larger program,
|
||||
in or on a volume of a storage or distribution medium, is called an
|
||||
"aggregate" if the compilation and its resulting copyright are not
|
||||
used to limit the access or legal rights of the compilation's users
|
||||
beyond what the individual works permit. Inclusion of a covered work
|
||||
in an aggregate does not cause this License to apply to the other
|
||||
parts of the aggregate.
|
||||
|
||||
6. Conveying Non-Source Forms.
|
||||
|
||||
You may convey a covered work in object code form under the terms
|
||||
of sections 4 and 5, provided that you also convey the
|
||||
machine-readable Corresponding Source under the terms of this License,
|
||||
in one of these ways:
|
||||
|
||||
a) Convey the object code in, or embodied in, a physical product
|
||||
(including a physical distribution medium), accompanied by the
|
||||
Corresponding Source fixed on a durable physical medium
|
||||
customarily used for software interchange.
|
||||
|
||||
b) Convey the object code in, or embodied in, a physical product
|
||||
(including a physical distribution medium), accompanied by a
|
||||
written offer, valid for at least three years and valid for as
|
||||
long as you offer spare parts or customer support for that product
|
||||
model, to give anyone who possesses the object code either (1) a
|
||||
copy of the Corresponding Source for all the software in the
|
||||
product that is covered by this License, on a durable physical
|
||||
medium customarily used for software interchange, for a price no
|
||||
more than your reasonable cost of physically performing this
|
||||
conveying of source, or (2) access to copy the
|
||||
Corresponding Source from a network server at no charge.
|
||||
|
||||
c) Convey individual copies of the object code with a copy of the
|
||||
written offer to provide the Corresponding Source. This
|
||||
alternative is allowed only occasionally and noncommercially, and
|
||||
only if you received the object code with such an offer, in accord
|
||||
with subsection 6b.
|
||||
|
||||
d) Convey the object code by offering access from a designated
|
||||
place (gratis or for a charge), and offer equivalent access to the
|
||||
Corresponding Source in the same way through the same place at no
|
||||
further charge. You need not require recipients to copy the
|
||||
Corresponding Source along with the object code. If the place to
|
||||
copy the object code is a network server, the Corresponding Source
|
||||
may be on a different server (operated by you or a third party)
|
||||
that supports equivalent copying facilities, provided you maintain
|
||||
clear directions next to the object code saying where to find the
|
||||
Corresponding Source. Regardless of what server hosts the
|
||||
Corresponding Source, you remain obligated to ensure that it is
|
||||
available for as long as needed to satisfy these requirements.
|
||||
|
||||
e) Convey the object code using peer-to-peer transmission, provided
|
||||
you inform other peers where the object code and Corresponding
|
||||
Source of the work are being offered to the general public at no
|
||||
charge under subsection 6d.
|
||||
|
||||
A separable portion of the object code, whose source code is excluded
|
||||
from the Corresponding Source as a System Library, need not be
|
||||
included in conveying the Corresponding Source.
|
||||
|
||||
You may not impose any further restrictions on the exercise of the
|
||||
rights granted or affirmed under this License. For example, you may
|
||||
not impose a license fee, royalty, or other charge for exercise of
|
||||
rights granted under this License, and you may not initiate litigation
|
||||
(including a cross-claim or counterclaim in a lawsuit) alleging that
|
||||
any patent claim is infringed by making, using, selling, offering for
|
||||
sale, or importing the Program or any portion of it.
|
||||
|
||||
7. Additional Terms.
|
||||
|
||||
"Additional permissions" are terms that supplement the terms of this
|
||||
License by making exceptions from one or more of its conditions.
|
||||
Additional permissions that are applicable to the entire Program shall
|
||||
be treated as though they were included in this License, to the extent
|
||||
that they are valid under applicable law. If additional permissions
|
||||
apply only to part of the Program, that part may be used separately
|
||||
under those permissions, but the entire Program remains governed by
|
||||
this License without regard to the additional permissions.
|
||||
|
||||
When you convey a copy of a covered work, you may at your option
|
||||
remove any additional permissions from that copy, or from any part of
|
||||
it. (Additional permissions may be written to require their own
|
||||
removal in certain cases when you modify the work.) You may place
|
||||
additional permissions on material, added by you to a covered work,
|
||||
for which you have or can give appropriate copyright permission.
|
||||
|
||||
Notwithstanding any other provision of this License, for material you
|
||||
add to a covered work, you may (if authorized by the copyright holders of
|
||||
that material) supplement the terms of this License with terms:
|
||||
|
||||
a) Disclaiming warranty or limiting liability differently from the
|
||||
terms of sections 15 and 16 of this License; or
|
||||
|
||||
b) Requiring preservation of specified reasonable legal notices or
|
||||
author attributions in that material or in the Appropriate Legal
|
||||
Notices displayed by works containing it; or
|
||||
|
||||
c) Prohibiting misrepresentation of the origin of that material, or
|
||||
requiring that modified versions of such material be marked in
|
||||
reasonable ways as different from the original version; or
|
||||
|
||||
d) Limiting the use for publicity purposes of names of licensors or
|
||||
authors of the material; or
|
||||
|
||||
e) Declining to grant rights under trademark law for use of some
|
||||
trade names, trademarks, or service marks; or
|
||||
|
||||
f) Requiring indemnification of licensors and authors of that
|
||||
material by anyone who conveys the material (or modified versions of
|
||||
it) with contractual assumptions of liability to the recipient, for
|
||||
any liability that these contractual assumptions directly impose on
|
||||
those licensors and authors.
|
||||
|
||||
All other non-permissive additional terms are considered "further
|
||||
restrictions" within the meaning of section 10. If the Program as you
|
||||
received it, or any part of it, contains a notice stating that it is
|
||||
governed by this License along with a term that is a further
|
||||
restriction, you may remove that term. If a license document contains
|
||||
a further restriction but permits relicensing or conveying under this
|
||||
License, you may add to a covered work material governed by the terms
|
||||
of that license document, provided that the further restriction does
|
||||
not survive such relicensing or conveying.
|
||||
|
||||
If you add terms to a covered work in accord with this section, you
|
||||
must place, in the relevant source files, a statement of the
|
||||
additional terms that apply to those files, or a notice indicating
|
||||
where to find the applicable terms.
|
||||
|
||||
Additional terms, permissive or non-permissive, may be stated in the
|
||||
form of a separately written license, or stated as exceptions;
|
||||
the above requirements apply either way.
|
||||
|
||||
8. Termination.
|
||||
|
||||
You may not propagate or modify a covered work except as expressly
|
||||
provided under this License. Any attempt otherwise to propagate or
|
||||
modify it is void, and will automatically terminate your rights under
|
||||
this License (including any patent licenses granted under the third
|
||||
paragraph of section 11).
|
||||
|
||||
However, if you cease all violation of this License, then your
|
||||
license from a particular copyright holder is reinstated (a)
|
||||
provisionally, unless and until the copyright holder explicitly and
|
||||
finally terminates your license, and (b) permanently, if the copyright
|
||||
holder fails to notify you of the violation by some reasonable means
|
||||
prior to 60 days after the cessation.
|
||||
|
||||
Moreover, your license from a particular copyright holder is
|
||||
reinstated permanently if the copyright holder notifies you of the
|
||||
violation by some reasonable means, this is the first time you have
|
||||
received notice of violation of this License (for any work) from that
|
||||
copyright holder, and you cure the violation prior to 30 days after
|
||||
your receipt of the notice.
|
||||
|
||||
Termination of your rights under this section does not terminate the
|
||||
licenses of parties who have received copies or rights from you under
|
||||
this License. If your rights have been terminated and not permanently
|
||||
reinstated, you do not qualify to receive new licenses for the same
|
||||
material under section 10.
|
||||
|
||||
9. Acceptance Not Required for Having Copies.
|
||||
|
||||
You are not required to accept this License in order to receive or
|
||||
run a copy of the Program. Ancillary propagation of a covered work
|
||||
occurring solely as a consequence of using peer-to-peer transmission
|
||||
to receive a copy likewise does not require acceptance. However,
|
||||
nothing other than this License grants you permission to propagate or
|
||||
modify any covered work. These actions infringe copyright if you do
|
||||
not accept this License. Therefore, by modifying or propagating a
|
||||
covered work, you indicate your acceptance of this License to do so.
|
||||
|
||||
10. Automatic Licensing of Downstream Recipients.
|
||||
|
||||
Each time you convey a covered work, the recipient automatically
|
||||
receives a license from the original licensors, to run, modify and
|
||||
propagate that work, subject to this License. You are not responsible
|
||||
for enforcing compliance by third parties with this License.
|
||||
|
||||
An "entity transaction" is a transaction transferring control of an
|
||||
organization, or substantially all assets of one, or subdividing an
|
||||
organization, or merging organizations. If propagation of a covered
|
||||
work results from an entity transaction, each party to that
|
||||
transaction who receives a copy of the work also receives whatever
|
||||
licenses to the work the party's predecessor in interest had or could
|
||||
give under the previous paragraph, plus a right to possession of the
|
||||
Corresponding Source of the work from the predecessor in interest, if
|
||||
the predecessor has it or can get it with reasonable efforts.
|
||||
|
||||
You may not impose any further restrictions on the exercise of the
|
||||
rights granted or affirmed under this License. For example, you may
|
||||
not impose a license fee, royalty, or other charge for exercise of
|
||||
rights granted under this License, and you may not initiate litigation
|
||||
(including a cross-claim or counterclaim in a lawsuit) alleging that
|
||||
any patent claim is infringed by making, using, selling, offering for
|
||||
sale, or importing the Program or any portion of it.
|
||||
|
||||
11. Patents.
|
||||
|
||||
A "contributor" is a copyright holder who authorizes use under this
|
||||
License of the Program or a work on which the Program is based. The
|
||||
work thus licensed is called the contributor's "contributor version".
|
||||
|
||||
A contributor's "essential patent claims" are all patent claims
|
||||
owned or controlled by the contributor, whether already acquired or
|
||||
hereafter acquired, that would be infringed by some manner, permitted
|
||||
by this License, of making, using, or selling its contributor version,
|
||||
but do not include claims that would be infringed only as a
|
||||
consequence of further modification of the contributor version. For
|
||||
purposes of this definition, "control" includes the right to grant
|
||||
patent sublicenses in a manner consistent with the requirements of
|
||||
this License.
|
||||
|
||||
Each contributor grants you a non-exclusive, worldwide, royalty-free
|
||||
patent license under the contributor's essential patent claims, to
|
||||
make, use, sell, offer for sale, import and otherwise run, modify and
|
||||
propagate the contents of its contributor version.
|
||||
|
||||
In the following three paragraphs, a "patent license" is any express
|
||||
agreement or commitment, however denominated, not to enforce a patent
|
||||
(such as an express permission to practice a patent or covenant not to
|
||||
sue for patent infringement). To "grant" such a patent license to a
|
||||
party means to make such an agreement or commitment not to enforce a
|
||||
patent against the party.
|
||||
|
||||
If you convey a covered work, knowingly relying on a patent license,
|
||||
and the Corresponding Source of the work is not available for anyone
|
||||
to copy, free of charge and under the terms of this License, through a
|
||||
publicly available network server or other readily accessible means,
|
||||
then you must either (1) cause the Corresponding Source to be so
|
||||
available, or (2) arrange to deprive yourself of the benefit of the
|
||||
patent license for this particular work, or (3) arrange, in a manner
|
||||
consistent with the requirements of this License, to extend the patent
|
||||
license to downstream recipients. "Knowingly relying" means you have
|
||||
actual knowledge that, but for the patent license, your conveying the
|
||||
covered work in a country, or your recipient's use of the covered work
|
||||
in a country, would infringe one or more identifiable patents in that
|
||||
country that you have reason to believe are valid.
|
||||
|
||||
If, pursuant to or in connection with a single transaction or
|
||||
arrangement, you convey, or propagate by procuring conveyance of, a
|
||||
covered work, and grant a patent license to some of the parties
|
||||
receiving the covered work authorizing them to use, propagate, modify
|
||||
or convey a specific copy of the covered work, then the patent license
|
||||
you grant is automatically extended to all recipients of the covered
|
||||
work and works based on it.
|
||||
|
||||
A patent license is "discriminatory" if it does not include within
|
||||
the scope of its coverage, prohibits the exercise of, or is
|
||||
conditioned on the non-exercise of one or more of the rights that are
|
||||
specifically granted under this License. You may not convey a covered
|
||||
work if you are a party to an arrangement with a third party that is
|
||||
in the business of distributing software, under which you make payment
|
||||
to the third party based on the extent of your activity of conveying
|
||||
the work, and under which the third party grants, to any of the
|
||||
parties who would receive the covered work from you, a discriminatory
|
||||
patent license (a) in connection with copies of the covered work
|
||||
conveyed by you (or copies made from those copies), or (b) primarily
|
||||
for and in connection with specific products or compilations that
|
||||
contain the covered work, unless you entered into that arrangement,
|
||||
or that patent license was granted, prior to 28 March 2007.
|
||||
|
||||
Nothing in this License shall be construed as excluding or limiting
|
||||
any implied license or other defenses to infringement that may
|
||||
otherwise be available to you under applicable patent law.
|
||||
|
||||
12. No Surrender of Others' Freedom.
|
||||
|
||||
If conditions are imposed on you (whether by court order, agreement or
|
||||
otherwise) that contradict the conditions of this License, they do not
|
||||
excuse you from the conditions of this License. If you cannot convey a
|
||||
covered work so as to satisfy simultaneously your obligations under this
|
||||
License and any other pertinent obligations, then as a consequence you may
|
||||
not convey it at all. For example, if you agree to terms that obligate you
|
||||
to collect a royalty for further conveying from those to whom you convey
|
||||
the Program, the only way you could satisfy both those terms and this
|
||||
License would be to refrain entirely from conveying the Program.
|
||||
|
||||
13. Use with the GNU Affero General Public License.
|
||||
|
||||
Notwithstanding any other provision of this License, you have
|
||||
permission to link or combine any covered work with a work licensed
|
||||
under version 3 of the GNU Affero General Public License into a single
|
||||
combined work, and to convey the resulting work. The terms of this
|
||||
License will continue to apply to the part which is the covered work,
|
||||
but the special requirements of the GNU Affero General Public License,
|
||||
section 13, concerning interaction through a network will apply to the
|
||||
combination as such.
|
||||
|
||||
14. Revised Versions of this License.
|
||||
|
||||
The Free Software Foundation may publish revised and/or new versions of
|
||||
the GNU General Public License from time to time. Such new versions will
|
||||
be similar in spirit to the present version, but may differ in detail to
|
||||
address new problems or concerns.
|
||||
|
||||
Each version is given a distinguishing version number. If the
|
||||
Program specifies that a certain numbered version of the GNU General
|
||||
Public License "or any later version" applies to it, you have the
|
||||
option of following the terms and conditions either of that numbered
|
||||
version or of any later version published by the Free Software
|
||||
Foundation. If the Program does not specify a version number of the
|
||||
GNU General Public License, you may choose any version ever published
|
||||
by the Free Software Foundation.
|
||||
|
||||
If the Program specifies that a proxy can decide which future
|
||||
versions of the GNU General Public License can be used, that proxy's
|
||||
public statement of acceptance of a version permanently authorizes you
|
||||
to choose that version for the Program.
|
||||
|
||||
Later license versions may give you additional or different
|
||||
permissions. However, no additional obligations are imposed on any
|
||||
author or copyright holder as a result of your choosing to follow a
|
||||
later version.
|
||||
|
||||
15. Disclaimer of Warranty.
|
||||
|
||||
THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
|
||||
APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
|
||||
HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
|
||||
OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
|
||||
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
||||
PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
|
||||
IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
|
||||
ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
|
||||
|
||||
16. Limitation of Liability.
|
||||
|
||||
IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
|
||||
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
|
||||
THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
|
||||
GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
|
||||
USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
|
||||
DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
|
||||
PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
|
||||
EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
|
||||
SUCH DAMAGES.
|
||||
|
||||
17. Interpretation of Sections 15 and 16.
|
||||
|
||||
If the disclaimer of warranty and limitation of liability provided
|
||||
above cannot be given local legal effect according to their terms,
|
||||
reviewing courts shall apply local law that most closely approximates
|
||||
an absolute waiver of all civil liability in connection with the
|
||||
Program, unless a warranty or assumption of liability accompanies a
|
||||
copy of the Program in return for a fee.
|
||||
|
||||
END OF TERMS AND CONDITIONS
|
||||
|
||||
How to Apply These Terms to Your New Programs
|
||||
|
||||
If you develop a new program, and you want it to be of the greatest
|
||||
possible use to the public, the best way to achieve this is to make it
|
||||
free software which everyone can redistribute and change under these terms.
|
||||
|
||||
To do so, attach the following notices to the program. It is safest
|
||||
to attach them to the start of each source file to most effectively
|
||||
state the exclusion of warranty; and each file should have at least
|
||||
the "copyright" line and a pointer to where the full notice is found.
|
||||
|
||||
<one line to give the program's name and a brief idea of what it does.>
|
||||
Copyright (C) <year> <name of author>
|
||||
|
||||
This program is free software: you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License as published by
|
||||
the Free Software Foundation, either version 3 of the License, or
|
||||
(at your option) any later version.
|
||||
|
||||
This program is distributed in the hope that it will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
GNU General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with this program. If not, see <https://www.gnu.org/licenses/>.
|
||||
|
||||
Also add information on how to contact you by electronic and paper mail.
|
||||
|
||||
If the program does terminal interaction, make it output a short
|
||||
notice like this when it starts in an interactive mode:
|
||||
|
||||
<program> Copyright (C) <year> <name of author>
|
||||
This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
|
||||
This is free software, and you are welcome to redistribute it
|
||||
under certain conditions; type `show c' for details.
|
||||
|
||||
The hypothetical commands `show w' and `show c' should show the appropriate
|
||||
parts of the General Public License. Of course, your program's commands
|
||||
might be different; for a GUI interface, you would use an "about box".
|
||||
|
||||
You should also get your employer (if you work as a programmer) or school,
|
||||
if any, to sign a "copyright disclaimer" for the program, if necessary.
|
||||
For more information on this, and how to apply and follow the GNU GPL, see
|
||||
<https://www.gnu.org/licenses/>.
|
||||
|
||||
The GNU General Public License does not permit incorporating your program
|
||||
into proprietary programs. If your program is a subroutine library, you
|
||||
may consider it more useful to permit linking proprietary applications with
|
||||
the library. If this is what you want to do, use the GNU Lesser General
|
||||
Public License instead of this License. But first, please read
|
||||
<https://www.gnu.org/licenses/why-not-lgpl.html>.
|
||||
502
README.md
Normal file
@@ -0,0 +1,502 @@
|
||||
# BTC 价格监控器
|
||||
|
||||
<div align="center">
|
||||
|
||||

|
||||

|
||||

|
||||

|
||||
|
||||
一款专业的 macOS 菜单栏应用,用于实时监控 BTC 价格,之前使用Python写过虽然也蛮好用但最终还是决定用macOS原生语言开发,已经编译了`Intel`与`Apple Silicon`的通用应用,请至releases下载。
|
||||
|
||||
[功能特性](#功能特性) • [安装要求](#安装要求) • [快速开始](#快速开始) • [使用说明](#使用说明) • [技术架构](#技术架构)
|
||||
|
||||
</div>
|
||||
|
||||
## 📷︎ 界面预览
|
||||
|
||||

|
||||
|
||||
## ✨ 功能特性
|
||||
|
||||
### 🚀 核心功能
|
||||
- **实时价格显示**: 在菜单栏实时显示 BTC/USDT 价格
|
||||
- **自动刷新机制**: 每 30 秒自动获取最新价格数据
|
||||
- **智能错误重试**: 网络异常时自动重试,最多 3 次
|
||||
- **手动刷新**: 支持快捷键 `Cmd+R` 手动刷新价格
|
||||
- **状态指示**: 直观显示加载、更新、错误状态
|
||||
|
||||
### 🎨 用户体验
|
||||
- **SF Symbols 图标**: 使用原生 macOS 图标系统
|
||||
- **中文界面**: 完整的中文用户界面
|
||||
- **优雅动画**: 流畅的状态切换动画
|
||||
- **轻量级设计**: 最小化系统资源占用
|
||||
- **后台运行**: 不占用 Dock 空间,专注菜单栏
|
||||
|
||||
### 🛡️ 可靠性
|
||||
- **网络容错**: 完善的网络异常处理机制
|
||||
- **内存管理**: 避免循环引用,及时释放资源
|
||||
- **线程安全**: UI 更新确保在主线程执行
|
||||
- **错误恢复**: 自动从临时网络故障中恢复
|
||||
|
||||
## 📋 安装要求
|
||||
|
||||
### 系统要求
|
||||
- **操作系统**: macOS 12.4 或更高版本
|
||||
- **推荐版本**: macOS 14.8 或更高版本
|
||||
- **架构支持**: Intel 和 Apple Silicon (M1/M2/M3/M4/M5)
|
||||
|
||||
### 开发环境
|
||||
- **开发工具**: Xcode 16.2 或更高版本
|
||||
- **Swift 版本**: Swift 5.0
|
||||
- **部署目标**: macOS 14.8
|
||||
|
||||
### 网络要求
|
||||
- 需要稳定的互联网连接
|
||||
- 访问币安 API (`https://api.binance.com`) 的网络权限
|
||||
|
||||
## 🚀 快速开始
|
||||
|
||||
### 方式一:直接运行 (推荐)
|
||||
|
||||
1. **克隆项目**
|
||||
```bash
|
||||
git clone https://github.com/your-username/btc-price-monitor.git
|
||||
cd btc-price-monitor
|
||||
```
|
||||
|
||||
2. **在 Xcode 中打开**
|
||||
```bash
|
||||
open "Bitcoin Monitoring.xcodeproj"
|
||||
```
|
||||
|
||||
3. **运行应用**
|
||||
- 在 Xcode 中选择 "Bitcoin Monitoring" scheme
|
||||
- 点击运行按钮或使用 `Cmd+R`
|
||||
|
||||
### 方式二:命令行构建
|
||||
|
||||
1. **构建项目**
|
||||
```bash
|
||||
xcodebuild -project "Bitcoin Monitoring.xcodeproj" \
|
||||
-scheme "Bitcoin Monitoring" \
|
||||
-configuration Debug build
|
||||
```
|
||||
|
||||
2. **运行应用**
|
||||
```bash
|
||||
open "build/Debug/Bitcoin Monitoring.app"
|
||||
```
|
||||
|
||||
### 方式三:发布版本构建
|
||||
|
||||
1. **构建发布版本**
|
||||
```bash
|
||||
xcodebuild -project "Bitcoin Monitoring.xcodeproj" \
|
||||
-scheme "Bitcoin Monitoring" \
|
||||
-configuration Release archive
|
||||
```
|
||||
|
||||
2. **导出应用**
|
||||
- 在 Xcode Organizer 中选择归档
|
||||
- 点击 "Distribute App" 并选择 "Copy App"
|
||||
- 将应用拖到 Applications 文件夹
|
||||
|
||||
## 📖 使用说明
|
||||
|
||||
### 基本操作
|
||||
|
||||
1. **启动应用**
|
||||
- 应用启动后自动在菜单栏显示 BTC 图标
|
||||
- 首次启动会显示 "加载中..." 状态
|
||||
|
||||
2. **查看价格**
|
||||
- 菜单栏实时显示当前 BTC 价格
|
||||
- 格式:`$价格` (例如: `$43,250.50`)
|
||||
|
||||
3. **交互菜单**
|
||||
- 点击菜单栏图标显示详细菜单
|
||||
- 查看更多信息并执行操作
|
||||
|
||||
### 菜单功能
|
||||
|
||||
| 功能 | 描述 | 快捷键 |
|
||||
|------|------|--------|
|
||||
| 价格信息 | 显示当前 BTC 价格和状态 | - |
|
||||
| 错误信息 | 显示网络错误详情 (如有) | - |
|
||||
| 更新时间 | 显示上次成功更新时间 | - |
|
||||
| 刷新价格 | 手动获取最新价格 | `Cmd+R` |
|
||||
| 关于 | 查看应用信息和版本 | - |
|
||||
| 退出 | 完全退出应用 | `Cmd+Q` |
|
||||
|
||||
### 状态说明
|
||||
|
||||
| 状态 | 显示 | 说明 |
|
||||
|------|------|------|
|
||||
| 加载中 | `加载中...` | 首次启动,正在获取数据 |
|
||||
| 更新中 | `更新中...` | 正在获取最新价格 |
|
||||
| 错误 | `错误` | 网络连接或 API 异常 |
|
||||
| 正常 | `$价格` | 成功显示当前价格 |
|
||||
|
||||
## 🏗️ 技术架构
|
||||
|
||||
### 架构概览
|
||||
|
||||
```
|
||||
BTC价格监控器架构
|
||||
├── 应用层 (App Layer)
|
||||
│ ├── test1App.swift (应用入口)
|
||||
│ └── AppDelegate (应用生命周期)
|
||||
├── 界面层 (UI Layer)
|
||||
│ └── BTCMenuBarApp.swift (菜单栏控制器)
|
||||
├── 业务层 (Business Layer)
|
||||
│ └── PriceManager.swift (价格管理器)
|
||||
├── 服务层 (Service Layer)
|
||||
│ └── PriceService.swift (网络服务)
|
||||
└── 数据层 (Data Layer)
|
||||
└── BTCPriceResponse.swift (数据模型)
|
||||
```
|
||||
|
||||
### 核心组件
|
||||
|
||||
#### **test1App.swift**
|
||||
- **职责**: 应用程序入口点
|
||||
- **功能**:
|
||||
- 配置应用为后台模式
|
||||
- 创建和初始化菜单栏应用
|
||||
- 管理应用生命周期
|
||||
|
||||
#### **BTCMenuBarApp.swift**
|
||||
- **职责**: 菜单栏界面控制器
|
||||
- **功能**:
|
||||
- 管理状态栏图标和文本
|
||||
- 处理用户交互事件
|
||||
- 显示上下文菜单
|
||||
- 更新 UI 状态
|
||||
|
||||
#### **PriceManager.swift**
|
||||
- **职责**: 价格数据管理器 (@MainActor)
|
||||
- **功能**:
|
||||
- 定时刷新机制 (30秒间隔)
|
||||
- 智能重试策略 (最多3次)
|
||||
- Combine 发布者模式
|
||||
- 状态管理和错误处理
|
||||
|
||||
#### **PriceService.swift**
|
||||
- **职责**: 网络请求服务层
|
||||
- **功能**:
|
||||
- 币安 API 集成
|
||||
- HTTP 网络请求处理
|
||||
- JSON 数据解析
|
||||
- 网络错误处理
|
||||
|
||||
#### **BTCPriceResponse.swift**
|
||||
- **职责**: API 响应数据模型
|
||||
- **功能**:
|
||||
- Codable 协议支持
|
||||
- 数据验证和转换
|
||||
- 类型安全的属性访问
|
||||
|
||||
### 设计模式
|
||||
|
||||
- **MVVM 架构**: SwiftUI + ObservableObject 模式
|
||||
- **Combine 框架**: 响应式数据流和事件处理
|
||||
- **依赖注入**: 服务层分离和松耦合设计
|
||||
- **单例模式**: PriceService 网络服务管理
|
||||
- **观察者模式**: 价格变化的响应式更新
|
||||
|
||||
### 并发处理
|
||||
|
||||
```swift
|
||||
// 主线程 UI 更新
|
||||
@MainActor
|
||||
class BTCMenuBarApp: ObservableObject
|
||||
|
||||
// 异步网络请求
|
||||
func fetchPrice() async throws -> Double
|
||||
|
||||
// Combine 响应式流
|
||||
priceManager.$currentPrice
|
||||
.receive(on: DispatchQueue.main)
|
||||
.sink { [weak self] price in
|
||||
self?.updateMenuBarTitle(price: price)
|
||||
}
|
||||
```
|
||||
|
||||
## 🌐 API 集成
|
||||
|
||||
### 币安 API 端点
|
||||
|
||||
```http
|
||||
GET https://api.binance.com/api/v3/ticker/price?symbol=BTCUSDT
|
||||
```
|
||||
|
||||
### 请求参数
|
||||
|
||||
| 参数 | 类型 | 必需 | 描述 |
|
||||
|------|------|------|------|
|
||||
| symbol | String | 是 | 交易对符号 (BTCUSDT) |
|
||||
|
||||
### 响应格式
|
||||
|
||||
```json
|
||||
{
|
||||
"symbol": "BTCUSDT",
|
||||
"price": "43250.50"
|
||||
}
|
||||
```
|
||||
|
||||
### 错误处理策略
|
||||
|
||||
1. **网络连接失败**
|
||||
- 自动重试机制 (最多3次)
|
||||
- 递增延迟策略 (1秒, 2秒, 4秒)
|
||||
- 用户友好的错误提示
|
||||
|
||||
2. **API 服务器错误**
|
||||
- HTTP 状态码检查
|
||||
- 服务器响应验证
|
||||
- 优雅降级处理
|
||||
|
||||
3. **数据解析异常**
|
||||
- JSON 格式验证
|
||||
- 数据类型检查
|
||||
- 价格格式验证
|
||||
|
||||
4. **无效价格格式**
|
||||
- 数值范围检查
|
||||
- 格式规范化
|
||||
- 异常值过滤
|
||||
|
||||
## 🛠️ 开发指南
|
||||
|
||||
### 添加新功能
|
||||
|
||||
#### 1. 添加新的加密货币支持
|
||||
|
||||
```swift
|
||||
// 在 BTCPriceResponse.swift 中扩展
|
||||
struct CryptoPriceResponse: Codable {
|
||||
let symbol: String
|
||||
let price: String
|
||||
}
|
||||
|
||||
// 在 PriceService.swift 中添加新方法
|
||||
func fetchETHPrice() async throws -> Double {
|
||||
// 实现 ETH 价格获取逻辑
|
||||
}
|
||||
```
|
||||
|
||||
#### 2. 添加价格历史功能
|
||||
|
||||
```swift
|
||||
// 在 PriceManager.swift 中添加
|
||||
@Published var priceHistory: [Double] = []
|
||||
|
||||
func updatePriceHistory(_ price: Double) {
|
||||
priceHistory.append(price)
|
||||
if priceHistory.count > 100 {
|
||||
priceHistory.removeFirst()
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
#### 3. 添加价格警报功能
|
||||
|
||||
```swift
|
||||
// 在 BTCMenuBarApp.swift 中扩展
|
||||
struct PriceAlert {
|
||||
let targetPrice: Double
|
||||
let direction: AlertDirection
|
||||
}
|
||||
|
||||
enum AlertDirection {
|
||||
case above, below
|
||||
}
|
||||
```
|
||||
|
||||
### 代码规范
|
||||
|
||||
#### Swift 命名约定
|
||||
```swift
|
||||
// 类名:大驼峰命名
|
||||
class PriceManager
|
||||
|
||||
// 方法名:小驼峰命名
|
||||
func fetchPrice()
|
||||
|
||||
// 变量名:小驼峰命名
|
||||
let currentPrice
|
||||
|
||||
// 常量:全大写
|
||||
let API_BASE_URL = "https://api.binance.com"
|
||||
```
|
||||
|
||||
#### 注释规范
|
||||
```swift
|
||||
/// 价格数据管理器
|
||||
///
|
||||
/// 负责管理 BTC 价格的获取、缓存和分发。
|
||||
/// 使用 Combine 框架提供响应式数据流。
|
||||
@MainActor
|
||||
class PriceManager: ObservableObject {
|
||||
|
||||
/// 当前 BTC 价格
|
||||
@Published var currentPrice: Double = 0.0
|
||||
|
||||
/// 获取最新价格
|
||||
/// - Throws: PriceError 网络或解析错误
|
||||
func refreshPrice() async {
|
||||
// 实现逻辑
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 调试技巧
|
||||
|
||||
#### 1. 启用详细日志
|
||||
```swift
|
||||
// 在 PriceService.swift 中添加
|
||||
private enum LogLevel {
|
||||
case info, warning, error
|
||||
}
|
||||
|
||||
private func log(_ message: String, level: LogLevel = .info) {
|
||||
let timestamp = DateFormatter.iso8601.string(from: Date())
|
||||
print("[\(timestamp)] [\(level)] \(message)")
|
||||
}
|
||||
```
|
||||
|
||||
#### 2. 网络请求调试
|
||||
```swift
|
||||
// 使用 Xcode 网络调试器
|
||||
// Product → Scheme → Edit Scheme → Run → Diagnostics
|
||||
// 启用 "Network" 选项
|
||||
|
||||
// 或者在代码中添加调试信息
|
||||
func fetchPrice() async throws -> Double {
|
||||
log("开始获取 BTC 价格", level: .info)
|
||||
|
||||
let startTime = CFAbsoluteTimeGetCurrent()
|
||||
defer {
|
||||
let duration = CFAbsoluteTimeGetCurrent() - startTime
|
||||
log("请求完成,耗时: \(String(format: "%.2f", duration))秒")
|
||||
}
|
||||
|
||||
// 网络请求实现
|
||||
}
|
||||
```
|
||||
|
||||
### 性能优化
|
||||
|
||||
#### 1. 定时器优化
|
||||
```swift
|
||||
// 使用 weak self 避免循环引用
|
||||
Timer.scheduledTimer(withTimeInterval: 30.0, repeats: true) { [weak self] _ in
|
||||
Task { @MainActor in
|
||||
await self?.refreshPrice()
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
#### 2. 网络请求优化
|
||||
```swift
|
||||
// 添加请求缓存
|
||||
private var lastFetchTime: Date = Date.distantPast
|
||||
private let cacheInterval: TimeInterval = 25.0 // 25秒缓存
|
||||
|
||||
func fetchPrice() async throws -> Double {
|
||||
let now = Date()
|
||||
if now.timeIntervalSince(lastFetchTime) < cacheInterval {
|
||||
return cachedPrice
|
||||
}
|
||||
|
||||
// 执行网络请求
|
||||
lastFetchTime = now
|
||||
return try await performNetworkRequest()
|
||||
}
|
||||
```
|
||||
|
||||
#### 3. UI 更新优化
|
||||
```swift
|
||||
// 批量 UI 更新
|
||||
DispatchQueue.main.async { [weak self] in
|
||||
guard let self = self else { return }
|
||||
|
||||
// 批量更新 UI 元素
|
||||
self.updateMenuBarIcon()
|
||||
self.updateMenuBarTitle()
|
||||
self.updateMenuItems()
|
||||
}
|
||||
```
|
||||
|
||||
## 🔧 故障排除
|
||||
|
||||
### 常见问题
|
||||
|
||||
#### 1. 应用无法启动
|
||||
|
||||
**问题**: 双击应用图标无反应
|
||||
**解决方案**:
|
||||
```bash
|
||||
# 检查系统完整性
|
||||
xattr -d com.apple.quarantine "/Applications/Bitcoin Monitoring.app"
|
||||
|
||||
# 或者在系统偏好设置中允许应用运行
|
||||
# 系统偏好设置 → 安全性与隐私 → 通用
|
||||
```
|
||||
|
||||
#### 2. 网络连接失败
|
||||
|
||||
**问题**: 显示"错误"状态,无法获取价格
|
||||
**诊断步骤**:
|
||||
1. 检查网络连接
|
||||
```bash
|
||||
ping api.binance.com
|
||||
```
|
||||
|
||||
2. 验证 API 可用性
|
||||
```bash
|
||||
curl "https://api.binance.com/api/v3/ticker/price?symbol=BTCUSDT"
|
||||
```
|
||||
|
||||
3. 检查防火墙设置
|
||||
```bash
|
||||
# 确保允许出站 HTTPS 连接
|
||||
```
|
||||
|
||||
## 🤝 贡献指南
|
||||
|
||||
我们欢迎所有形式的贡献!请阅读以下指南:
|
||||
|
||||
### 贡献方式
|
||||
|
||||
1. **报告 Bug**: 在 Issues 中提交详细的 Bug 报告
|
||||
2. **功能建议**: 提出新功能的想法和建议
|
||||
3. **代码贡献**: 提交 Pull Request 改进代码
|
||||
4. **文档完善**: 改进 README 和代码注释
|
||||
|
||||
## 📄 许可证
|
||||
|
||||
本项目采用 **GNU General Public License v3.0** 许可证。
|
||||
|
||||
### 完整许可证文本
|
||||
|
||||
详见 [LICENSE](LICENSE) 文件。
|
||||
|
||||
## 👨💻 作者
|
||||
|
||||
**Mark**
|
||||
|
||||
- **GitHub**: [@jiayouzl](https://github.com/jiayouzl/)
|
||||
- **项目主页**: [https://github.com/jiayouzl/Bitcoin-Monitoring](https://github.com/jiayouzl/Bitcoin-Monitoring)
|
||||
|
||||
---
|
||||
|
||||
<div align="center">
|
||||
|
||||
**⭐ 如果这个项目对你有帮助,请给它一个 Star!**
|
||||
|
||||
Made with ❤️ for the Bitcoin community
|
||||
|
||||
</div>
|
||||
BIN
assets/iShot_2025-10-28_20.27.11.png
Normal file
|
After Width: | Height: | Size: 96 KiB |
56
test1/Assets.xcassets/AppIcon.appiconset/Contents.json
Normal file → Executable file
@@ -1,58 +1,56 @@
|
||||
{
|
||||
"images" : [
|
||||
{
|
||||
"size" : "128x128",
|
||||
"idiom" : "mac",
|
||||
"scale" : "1x",
|
||||
"size" : "16x16"
|
||||
"filename" : "icon_128x128.png",
|
||||
"scale" : "1x"
|
||||
},
|
||||
{
|
||||
"size" : "256x256",
|
||||
"idiom" : "mac",
|
||||
"scale" : "2x",
|
||||
"size" : "16x16"
|
||||
"filename" : "icon_256x256@2x.png",
|
||||
"scale" : "2x"
|
||||
},
|
||||
{
|
||||
"size" : "512x512",
|
||||
"idiom" : "mac",
|
||||
"scale" : "1x",
|
||||
"size" : "32x32"
|
||||
"filename" : "icon_512x512.png",
|
||||
"scale" : "1x"
|
||||
},
|
||||
{
|
||||
"size" : "16x16",
|
||||
"idiom" : "mac",
|
||||
"scale" : "2x",
|
||||
"size" : "32x32"
|
||||
"filename" : "icon_16x16.png",
|
||||
"scale" : "1x"
|
||||
},
|
||||
{
|
||||
"size" : "16x16",
|
||||
"idiom" : "mac",
|
||||
"scale" : "1x",
|
||||
"size" : "128x128"
|
||||
"filename" : "icon_16x16@2x.png",
|
||||
"scale" : "2x"
|
||||
},
|
||||
{
|
||||
"size" : "128x128",
|
||||
"idiom" : "mac",
|
||||
"scale" : "2x",
|
||||
"size" : "128x128"
|
||||
"filename" : "icon_128x128@2x.png",
|
||||
"scale" : "2x"
|
||||
},
|
||||
{
|
||||
"size" : "512x512",
|
||||
"idiom" : "mac",
|
||||
"scale" : "1x",
|
||||
"size" : "256x256"
|
||||
"filename" : "icon_512x512@2x.png",
|
||||
"scale" : "2x"
|
||||
},
|
||||
{
|
||||
"size" : "256x256",
|
||||
"idiom" : "mac",
|
||||
"scale" : "2x",
|
||||
"size" : "256x256"
|
||||
},
|
||||
{
|
||||
"idiom" : "mac",
|
||||
"scale" : "1x",
|
||||
"size" : "512x512"
|
||||
},
|
||||
{
|
||||
"idiom" : "mac",
|
||||
"scale" : "2x",
|
||||
"size" : "512x512"
|
||||
"filename" : "icon_256x256.png",
|
||||
"scale" : "1x"
|
||||
}
|
||||
],
|
||||
"info" : {
|
||||
"author" : "xcode",
|
||||
"version" : 1
|
||||
"version" : 1,
|
||||
"author" : "xcode"
|
||||
}
|
||||
}
|
||||
}
|
||||
BIN
test1/Assets.xcassets/AppIcon.appiconset/icon_128x128.png
Executable file
|
After Width: | Height: | Size: 6.2 KiB |
BIN
test1/Assets.xcassets/AppIcon.appiconset/icon_128x128@2x.png
Executable file
|
After Width: | Height: | Size: 31 KiB |
BIN
test1/Assets.xcassets/AppIcon.appiconset/icon_16x16.png
Executable file
|
After Width: | Height: | Size: 1.0 KiB |
BIN
test1/Assets.xcassets/AppIcon.appiconset/icon_16x16@2x.png
Executable file
|
After Width: | Height: | Size: 1.7 KiB |
BIN
test1/Assets.xcassets/AppIcon.appiconset/icon_256x256.png
Executable file
|
After Width: | Height: | Size: 31 KiB |
BIN
test1/Assets.xcassets/AppIcon.appiconset/icon_256x256@2x.png
Executable file
|
After Width: | Height: | Size: 80 KiB |
BIN
test1/Assets.xcassets/AppIcon.appiconset/icon_512x512.png
Executable file
|
After Width: | Height: | Size: 80 KiB |
BIN
test1/Assets.xcassets/AppIcon.appiconset/icon_512x512@2x.png
Executable file
|
After Width: | Height: | Size: 202 KiB |
212
test1/BTCMenuBarApp.swift
Normal file
@@ -0,0 +1,212 @@
|
||||
//
|
||||
// BTCMenuBarApp.swift
|
||||
// test1
|
||||
//
|
||||
// Created by zl_vm on 2025/10/28.
|
||||
//
|
||||
|
||||
import SwiftUI
|
||||
import AppKit
|
||||
import Combine
|
||||
|
||||
// macOS菜单栏应用主类
|
||||
@MainActor
|
||||
class BTCMenuBarApp: NSObject, ObservableObject {
|
||||
private var statusItem: NSStatusItem?
|
||||
private var popover: NSPopover?
|
||||
private var priceManager = PriceManager()
|
||||
private var cancellables = Set<AnyCancellable>()
|
||||
|
||||
override init() {
|
||||
super.init()
|
||||
setupMenuBar()
|
||||
}
|
||||
|
||||
// 设置菜单栏
|
||||
private func setupMenuBar() {
|
||||
// 创建状态栏项目
|
||||
statusItem = NSStatusBar.system.statusItem(withLength: NSStatusItem.variableLength)
|
||||
|
||||
guard let statusItem = statusItem else {
|
||||
print("❌ 无法创建状态栏项目")
|
||||
return
|
||||
}
|
||||
|
||||
guard let button = statusItem.button else {
|
||||
print("❌ 无法获取状态栏按钮")
|
||||
return
|
||||
}
|
||||
|
||||
// 设置BTC图标和标题
|
||||
updateMenuBarTitle(price: 0.0)
|
||||
button.action = #selector(menuBarClicked)
|
||||
button.target = self
|
||||
|
||||
// 监听价格变化
|
||||
priceManager.$currentPrice
|
||||
.receive(on: DispatchQueue.main)
|
||||
.sink { [weak self] price in
|
||||
self?.updateMenuBarTitle(price: price)
|
||||
}
|
||||
.store(in: &cancellables)
|
||||
}
|
||||
|
||||
// 更新菜单栏标题
|
||||
private func updateMenuBarTitle(price: Double) {
|
||||
DispatchQueue.main.async {
|
||||
guard let button = self.statusItem?.button else { return }
|
||||
|
||||
// 创建BTC图标
|
||||
let btcImage = NSImage(systemSymbolName: "bitcoinsign.circle.fill", accessibilityDescription: "BTC")
|
||||
btcImage?.size = NSSize(width: 16, height: 16)
|
||||
|
||||
// 设置图标
|
||||
button.image = btcImage
|
||||
|
||||
// 根据状态设置标题
|
||||
if price == 0.0 {
|
||||
if self.priceManager.isFetching {
|
||||
button.title = " 更新中..."
|
||||
} else if self.priceManager.lastError != nil {
|
||||
button.title = " 错误"
|
||||
} else {
|
||||
button.title = " 加载中..."
|
||||
}
|
||||
} else {
|
||||
button.title = String(format: " $%.2f", price)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// 菜单栏点击事件
|
||||
@objc private func menuBarClicked() {
|
||||
guard let button = statusItem?.button else {
|
||||
print("❌ 无法获取状态栏按钮")
|
||||
return
|
||||
}
|
||||
showMenu(from: button)
|
||||
}
|
||||
|
||||
// 显示菜单
|
||||
private func showMenu(from view: NSView) {
|
||||
let menu = NSMenu()
|
||||
|
||||
// 添加价格信息项(带BTC图标)
|
||||
let priceItem = NSMenuItem(title: priceManager.formattedPrice, action: nil, keyEquivalent: "")
|
||||
if let btcImage = NSImage(systemSymbolName: "bitcoinsign.circle.fill", accessibilityDescription: "BTC") {
|
||||
btcImage.size = NSSize(width: 16, height: 16)
|
||||
priceItem.image = btcImage
|
||||
}
|
||||
priceItem.isEnabled = false
|
||||
menu.addItem(priceItem)
|
||||
|
||||
// 如果有错误,显示错误信息(带错误图标)
|
||||
if let errorMessage = priceManager.errorMessage {
|
||||
let errorItem = NSMenuItem(title: "错误: \(errorMessage)", action: nil, keyEquivalent: "")
|
||||
if let errorImage = NSImage(systemSymbolName: "exclamationmark.triangle.fill", accessibilityDescription: "错误") {
|
||||
errorImage.size = NSSize(width: 16, height: 16)
|
||||
errorItem.image = errorImage
|
||||
}
|
||||
errorItem.isEnabled = false
|
||||
menu.addItem(errorItem)
|
||||
menu.addItem(NSMenuItem.separator())
|
||||
}
|
||||
|
||||
// 添加最后更新时间(带时钟图标)
|
||||
let timeItem = NSMenuItem(title: "上次更新: \(getCurrentTime())", action: nil, keyEquivalent: "")
|
||||
if let clockImage = NSImage(systemSymbolName: "clock", accessibilityDescription: "时间") {
|
||||
clockImage.size = NSSize(width: 16, height: 16)
|
||||
timeItem.image = clockImage
|
||||
}
|
||||
timeItem.isEnabled = false
|
||||
menu.addItem(timeItem)
|
||||
|
||||
menu.addItem(NSMenuItem.separator())
|
||||
|
||||
// 添加刷新按钮(带刷新图标)
|
||||
let refreshTitle = priceManager.isFetching ? "刷新中..." : "刷新价格"
|
||||
let refreshItem = NSMenuItem(title: refreshTitle, action: #selector(refreshPrice), keyEquivalent: "r")
|
||||
if let refreshImage = NSImage(systemSymbolName: priceManager.isFetching ? "hourglass" : "arrow.clockwise", accessibilityDescription: "刷新") {
|
||||
refreshImage.size = NSSize(width: 16, height: 16)
|
||||
refreshItem.image = refreshImage
|
||||
}
|
||||
refreshItem.target = self
|
||||
refreshItem.isEnabled = !priceManager.isFetching
|
||||
menu.addItem(refreshItem)
|
||||
|
||||
menu.addItem(NSMenuItem.separator())
|
||||
|
||||
// 添加关于按钮(带信息图标)
|
||||
let aboutItem = NSMenuItem(title: "关于", action: #selector(showAbout), keyEquivalent: "")
|
||||
if let infoImage = NSImage(systemSymbolName: "info.circle", accessibilityDescription: "关于") {
|
||||
infoImage.size = NSSize(width: 16, height: 16)
|
||||
aboutItem.image = infoImage
|
||||
}
|
||||
aboutItem.target = self
|
||||
menu.addItem(aboutItem)
|
||||
|
||||
// 添加退出按钮(带退出图标)
|
||||
let quitItem = NSMenuItem(title: "退出", action: #selector(quitApp), keyEquivalent: "q")
|
||||
if let quitImage = NSImage(systemSymbolName: "power", accessibilityDescription: "退出") {
|
||||
quitImage.size = NSSize(width: 16, height: 16)
|
||||
quitItem.image = quitImage
|
||||
}
|
||||
quitItem.target = self
|
||||
menu.addItem(quitItem)
|
||||
|
||||
// 安全显示菜单
|
||||
guard let statusItem = statusItem,
|
||||
let button = statusItem.button else {
|
||||
print("❌ 无法显示菜单 - 状态栏项目不可用")
|
||||
return
|
||||
}
|
||||
|
||||
statusItem.menu = menu
|
||||
button.performClick(nil)
|
||||
statusItem.menu = nil
|
||||
}
|
||||
|
||||
// 获取当前时间字符串
|
||||
private func getCurrentTime() -> String {
|
||||
let formatter = DateFormatter()
|
||||
formatter.timeStyle = .medium
|
||||
return formatter.string(from: Date())
|
||||
}
|
||||
|
||||
// 刷新价格
|
||||
@objc private func refreshPrice() {
|
||||
Task {
|
||||
await priceManager.refreshPrice()
|
||||
}
|
||||
}
|
||||
|
||||
// 显示关于对话框
|
||||
@objc private func showAbout() {
|
||||
let alert = NSAlert()
|
||||
alert.messageText = "BTC价格监控器"
|
||||
alert.informativeText = """
|
||||
🚀 一个专业的macOS菜单栏应用,用于实时显示BTC价格
|
||||
|
||||
✨ 功能特性:
|
||||
• 实时显示BTC/USDT价格
|
||||
• 每30秒自动刷新
|
||||
• 支持手动刷新 (Cmd+R)
|
||||
• 智能错误重试机制
|
||||
• 优雅的SF Symbols图标
|
||||
|
||||
📊 技术信息:
|
||||
数据来源:币安官方API
|
||||
作者:张雷
|
||||
版本:1.0.0
|
||||
架构:SwiftUI + AppKit
|
||||
"""
|
||||
alert.alertStyle = .informational
|
||||
alert.addButton(withTitle: "确定")
|
||||
alert.runModal()
|
||||
}
|
||||
|
||||
// 退出应用
|
||||
@objc private func quitApp() {
|
||||
NSApplication.shared.terminate(nil)
|
||||
}
|
||||
}
|
||||
14
test1/BTCPriceResponse.swift
Normal file
@@ -0,0 +1,14 @@
|
||||
//
|
||||
// BTCPriceResponse.swift
|
||||
// test1
|
||||
//
|
||||
// Created by zl_vm on 2025/10/28.
|
||||
//
|
||||
|
||||
import Foundation
|
||||
|
||||
// BTC价格响应数据模型
|
||||
struct BTCPriceResponse: Codable {
|
||||
let symbol: String
|
||||
let price: String
|
||||
}
|
||||
112
test1/PriceManager.swift
Normal file
@@ -0,0 +1,112 @@
|
||||
//
|
||||
// PriceManager.swift
|
||||
// test1
|
||||
//
|
||||
// Created by zl_vm on 2025/10/28.
|
||||
//
|
||||
|
||||
import Foundation
|
||||
import Combine
|
||||
|
||||
// 价格管理器,负责定时刷新BTC价格
|
||||
@MainActor
|
||||
class PriceManager: ObservableObject {
|
||||
@Published var currentPrice: Double = 0.0
|
||||
@Published var isFetching: Bool = false
|
||||
@Published var lastError: PriceError?
|
||||
|
||||
private let priceService = PriceService()
|
||||
private var timer: Timer?
|
||||
private let refreshInterval: TimeInterval = 30.0 // 30秒刷新一次
|
||||
|
||||
init() {
|
||||
startPriceUpdates()
|
||||
}
|
||||
|
||||
deinit {
|
||||
// 在deinit中不能直接调用@MainActor方法
|
||||
timer?.invalidate()
|
||||
timer = nil
|
||||
}
|
||||
|
||||
// 开始定时更新价格
|
||||
func startPriceUpdates() {
|
||||
// 立即获取一次价格
|
||||
Task {
|
||||
await fetchPrice()
|
||||
}
|
||||
|
||||
// 设置定时器,使用weak self避免循环引用
|
||||
timer = Timer.scheduledTimer(withTimeInterval: refreshInterval, repeats: true) { [weak self] _ in
|
||||
Task { @MainActor in
|
||||
await self?.fetchPrice()
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// 停止价格更新
|
||||
@MainActor
|
||||
func stopPriceUpdates() {
|
||||
timer?.invalidate()
|
||||
timer = nil
|
||||
}
|
||||
|
||||
// 手动刷新价格
|
||||
func refreshPrice() async {
|
||||
await fetchPrice()
|
||||
}
|
||||
|
||||
// 获取价格的核心方法(带重试机制)
|
||||
private func fetchPrice() async {
|
||||
isFetching = true
|
||||
lastError = nil
|
||||
|
||||
// 重试最多3次
|
||||
let maxRetries = 3
|
||||
|
||||
for attempt in 1...maxRetries {
|
||||
do {
|
||||
let price = try await priceService.fetchBTCPrice()
|
||||
currentPrice = price
|
||||
break // 成功获取价格,退出重试循环
|
||||
} catch let error as PriceError {
|
||||
if attempt == maxRetries {
|
||||
lastError = error
|
||||
} else {
|
||||
// 等待一段时间再重试
|
||||
try? await Task.sleep(nanoseconds: UInt64(attempt * 1_000_000_000)) // 递增延迟
|
||||
}
|
||||
} catch {
|
||||
if attempt == maxRetries {
|
||||
lastError = .networkError(error)
|
||||
} else {
|
||||
try? await Task.sleep(nanoseconds: UInt64(attempt * 1_000_000_000))
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
isFetching = false
|
||||
}
|
||||
|
||||
// 格式化价格显示
|
||||
var formattedPrice: String {
|
||||
if isFetching {
|
||||
return "BTC: 更新中..."
|
||||
}
|
||||
|
||||
if lastError != nil {
|
||||
return "BTC: 错误"
|
||||
}
|
||||
|
||||
if currentPrice == 0.0 {
|
||||
return "BTC: 加载中..."
|
||||
}
|
||||
|
||||
return String(format: "BTC: $%.2f", currentPrice)
|
||||
}
|
||||
|
||||
// 获取详细错误信息
|
||||
var errorMessage: String? {
|
||||
return lastError?.localizedDescription
|
||||
}
|
||||
}
|
||||
69
test1/PriceService.swift
Normal file
@@ -0,0 +1,69 @@
|
||||
//
|
||||
// PriceService.swift
|
||||
// test1
|
||||
//
|
||||
// Created by zl_vm on 2025/10/28.
|
||||
//
|
||||
|
||||
import Foundation
|
||||
|
||||
// 网络服务类,负责从币安API获取BTC价格
|
||||
class PriceService: ObservableObject {
|
||||
private let baseURL = "https://api.binance.com/api/v3/ticker/price"
|
||||
private let session = URLSession.shared
|
||||
|
||||
// 获取BTC价格
|
||||
func fetchBTCPrice() async throws -> Double {
|
||||
let urlString = "\(baseURL)?symbol=BTCUSDT"
|
||||
guard let url = URL(string: urlString) else {
|
||||
throw PriceError.invalidURL
|
||||
}
|
||||
|
||||
// 发送网络请求
|
||||
let (data, response) = try await session.data(from: url)
|
||||
|
||||
// 检查响应状态
|
||||
guard let httpResponse = response as? HTTPURLResponse else {
|
||||
throw PriceError.invalidResponse
|
||||
}
|
||||
|
||||
guard httpResponse.statusCode == 200 else {
|
||||
throw PriceError.serverError(httpResponse.statusCode)
|
||||
}
|
||||
|
||||
// 解析JSON数据
|
||||
let decoder = JSONDecoder()
|
||||
let priceResponse = try decoder.decode(BTCPriceResponse.self, from: data)
|
||||
|
||||
// 转换价格为Double类型
|
||||
guard let price = Double(priceResponse.price) else {
|
||||
throw PriceError.invalidPrice
|
||||
}
|
||||
|
||||
return price
|
||||
}
|
||||
}
|
||||
|
||||
// 价格服务错误类型
|
||||
enum PriceError: Error, LocalizedError {
|
||||
case invalidURL
|
||||
case invalidResponse
|
||||
case serverError(Int)
|
||||
case invalidPrice
|
||||
case networkError(Error)
|
||||
|
||||
var errorDescription: String? {
|
||||
switch self {
|
||||
case .invalidURL:
|
||||
return "无效的URL"
|
||||
case .invalidResponse:
|
||||
return "无效的响应"
|
||||
case .serverError(let code):
|
||||
return "服务器错误,状态码:\(code)"
|
||||
case .invalidPrice:
|
||||
return "无效的价格数据"
|
||||
case .networkError(let error):
|
||||
return "网络错误:\(error.localizedDescription)"
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -6,5 +6,9 @@
|
||||
<true/>
|
||||
<key>com.apple.security.files.user-selected.read-only</key>
|
||||
<true/>
|
||||
<key>com.apple.security.network.client</key>
|
||||
<true/>
|
||||
<key>com.apple.security.network.server</key>
|
||||
<false/>
|
||||
</dict>
|
||||
</plist>
|
||||
|
||||
@@ -6,12 +6,38 @@
|
||||
//
|
||||
|
||||
import SwiftUI
|
||||
import AppKit
|
||||
|
||||
@main
|
||||
struct test1App: App {
|
||||
@NSApplicationDelegateAdaptor(AppDelegate.self) var appDelegate
|
||||
|
||||
var body: some Scene {
|
||||
WindowGroup {
|
||||
ContentView()
|
||||
Settings {
|
||||
EmptyView()
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
class AppDelegate: NSObject, NSApplicationDelegate {
|
||||
var menuBarApp: BTCMenuBarApp?
|
||||
|
||||
func applicationDidFinishLaunching(_ notification: Notification) {
|
||||
// 设置应用为后台应用(不显示在Dock中)
|
||||
NSApp.setActivationPolicy(.accessory)
|
||||
|
||||
// 隐藏默认窗口(如果存在)
|
||||
if let window = NSApp.windows.first {
|
||||
window.setIsVisible(false)
|
||||
}
|
||||
|
||||
// 创建菜单栏应用
|
||||
menuBarApp = BTCMenuBarApp()
|
||||
}
|
||||
|
||||
func applicationShouldTerminate(_ sender: NSApplication) -> NSApplication.TerminateReply {
|
||||
// 清理资源
|
||||
menuBarApp = nil
|
||||
return .terminateNow
|
||||
}
|
||||
}
|
||||
|
||||