appcask 0.4.0 → 0.6.0

data/README.md

@@ -1,159 +1,159 @@
-# AppCask - App Store 资源下载工具
+# AppCask - App Store Resources Downloader
 
 <div align="center">
 
-![Version](https://img.shields.io/badge/version-0.3.0-blue.svg)
+![Version](https://img.shields.io/badge/version-0.6.0-blue.svg)
 ![Ruby](https://img.shields.io/badge/ruby-%3E%3D%203.2.0-red.svg)
 ![License](https://img.shields.io/badge/license-MIT-green.svg)
 
-一个全能的命令行工具,用于下载 iOS App Store 的应用资源  
-**图标 · 截图 · 应用简介 · 一键打包**
+An all-in-one command-line tool for downloading resources of iOS App Store apps
+**Icons • Screenshots • App Description • One-click Packaging**
 
-[功能特性](#-功能特性) • [安装](#-安装) • [使用指南](#-使用指南) • [示例](#-使用示例)
+[Features](#-features) • [Installation](#-installation) • [Usage Guide](#-usage-guide) • [Examples](#-usage-examples)
 
 </div>
 
 ---
 
-## ✨ 功能特性
-
-### 🎨 图标下载
-- 支持 4 种尺寸：60x60、100x100、512x512、1024x1024
-- 自动检测图片格式 (PNG/JPG/GIF/WEBP)
-- 智能文件命名
-
-### 📸 截图下载
-- iPhone 截图
-- iPad 截图
-- 批量下载所有截图
-- 自动分类保存
-
-### 📝 应用信息导出
-- **TXT 格式** - 易读的文本文件
-- **JSON 格式** - 结构化数据
-- **Markdown 格式** - 精美的文档
-
-包含信息：
-- 基本信息（名称、开发者、Bundle ID）
-- 版本信息（当前版本、文件大小、系统要求）
-- 评分统计（平均分、评分数量）
-- 价格信息
-- 应用描述
-- 版本更新说明
-- 相关链接
-
-### 📦 一键完整包
-下载应用的所有资源，包括：
-- 所有尺寸的图标
-- 所有设备的截图
-- 完整的应用信息（3种格式）
-
-### 🌍 多区域支持
-- 🇺🇸 美国 (us)
-- 🇨🇳 中国 (cn)
-- 🇯🇵 日本 (jp)
-- 🇰🇷 韩国 (kr)
-- 🇭🇰 香港 (hk)
-- 🇹🇼 台湾 (tw)
-- 🇬🇧 英国 (gb)
-- 🇩🇪 德国 (de)
-- 🇫🇷 法国 (fr)
+## ✨ Features
+
+### 🎨 Icon Download
+- Supports four sizes: 60x60, 100x100, 512x512, 1024x1024
+- Auto-detect image formats (PNG/JPG/GIF/WEBP)
+- Intelligent file naming
+
+### 📸 Screenshot Download
+- iPhone screenshots
+- iPad screenshots
+- Batch download all screenshots
+- Automatic organization and saving
+
+### 📝 Export App Information
+- **TXT format** - Human-readable text
+- **JSON format** - Structured data
+- **Markdown format** - Elegant documentation
+
+Included information:
+- Basic information (name, developer, Bundle ID)
+- Version information (current version, file size, system requirements)
+- Rating statistics (average rating, number of ratings)
+- Pricing information
+- App description
+- Version update notes
+- Related links
+
+### 📦 One-click Full Package
+Download all resources for the app, including:
+- Icons in all sizes
+- Screenshots for all devices
+- Complete app information (in 3 formats)
+
+### 🌍 Multiregion Support
+- 🇺🇸 United States (US)
+- 🇨🇳 China (CN)
+- 🇯🇵 Japan (JP)
+- 🇰🇷 Korea (KR)
+- 🇭🇰 Hong Kong (HK)
+- 🇹🇼 Taiwan (TW)
+- 🇬🇧 United Kingdom (GB)
+- 🇩🇪 Germany (DE)
+- 🇫🇷 France (FR)
 
 ---
 
-## 📦 安装
+## 📦 Installation
 
 ```bash
 gem install appcask
 ```
 
-或从源码安装:
+Or from source:
 
 ```bash
 git clone https://github.com/yourusername/appcask.git
 cd appcask
 bundle install
 rake build
-gem install pkg/appcask-1.0.0.gem
+gem install pkg/appcask-0.6.0.gem
 ```
 
 ---
 
-## 🚀 快速开始
+## 🚀 Quick Start
 
 ```bash
-# 交互模式
+# Interactive mode
 appcask
 
-# 快速搜索
+# Quick search
 appcask "Instagram"
 
-# 指定区域
-appcask "微信" cn
+# Specify region
+appcask "WeChat" cn
 ```
 
-### 完整演示
+### Full Demo
 
 ```
 $ appcask "Twitter"
 
 ╔═══════════════════════════════════════════╗
-║      AppCask - App 资源下载工具           ║
-║              v1.0.0                       ║
+║      AppCask - App Resources Downloader  ║
+║              v0.6.0                       ║
 ╚═══════════════════════════════════════════╝
 
-🔍 正在搜索 "Twitter"...
+🔍 Searching for "Twitter"...
 
-📋 找到 3 个结果:
+📋 Found 3 results:
 
   [0] X
-      开发者: X Corp. | 版本: 10.31
-      价格: Free | 评分: ⭐ 4.2
+      Developer: X Corp. | Version: 10.31
+      Price: Free | Rating: ⭐ 4.2
 
-请选择 (0-2, 或按q退出): 0
+Please choose (0-2, or press q to quit): 0
 
-✅ 已选择: X
+✅ Selected: X
 
-📦 选择下载内容:
-  [1] 图标
-  [2] 截图
-  [3] 简介信息
-  [4] 完整包(图标+截图+简介)
+📦 Choose content to download:
+  [1] Icon
+  [2] Screenshots
+  [3] Description
+  [4] Full package (Icons + Screenshots + Description)
 
-请选择 (1-4): 4
+Please choose (1-4): 4
 
-✨ 下载完成!
+✨ Download complete!
 📁 ~/Desktop/AppCask Downloads/X
-📊 统计: 15 个文件, 总大小 8.45 MB
+📊 Stats: 15 files, total size 8.45 MB
 ```
 
 ---
 
-## 📖 使用示例
+## 📖 Usage Examples
 
-### 仅下载图标
+### Download Only Icons
 
 ```bash
 appcask "Instagram"
-# 选择: [1] 图标 → [3] 1024x1024
+# Choose: [1] Icons → [3] 1024x1024
 ```
 
-### 下载所有截图
+### Download All Screenshots
 
 ```bash
-appcask "王者荣耀" cn
-# 选择: [2] 截图 → all
+appcask "Honor of Kings" cn
+# Choose: [2] Screenshots → all
 ```
 
-### 导出应用信息
+### Export App Information
 
 ```bash
 appcask "Notion"
-# 选择: [3] 简介信息
-# 输出: TXT + JSON + Markdown
+# Choose: [3] Description
+# Output: TXT + JSON + Markdown
 ```
 
-### 批量下载
+### Batch Download
 
 ```ruby
 #!/usr/bin/env ruby
@@ -168,7 +168,7 @@ end
 
 ---
 
-## 📂 文件结构
+## 📂 File Structure
 
 ```
 AppCask Downloads/
@@ -188,57 +188,57 @@ AppCask Downloads/
 
 ---
 
-## 🔧 高级功能
+## 🔧 Advanced Features
 
-### Debug 模式
+### Debug Mode
 
 ```bash
 DEBUG=1 appcask "AppName"
 ```
 
-### 快捷操作
+### Quick Operations
 
-- **回车** - 默认选项
-- **q** - 退出
-- **Ctrl+C** - 中断
+- **Enter** - Default option
+- **q** - Quit
+- **Ctrl+C** - Interrupt
 
 ---
 
-## 🐛 故障排除
+## 🐛 Troubleshooting
 
-**Q: 搜索不到应用？**  
-A: 确认拼写、尝试切换区域
+**Q: Can't find the app?**
+A: Check spelling and try switching regions
 
-**Q: 图标尺寸不对？**  
-A: 部分应用不支持 1024x1024
+**Q: Icon size is wrong?**
+A: Some apps do not support 1024x1024
 
-**Q: 网络超时？**  
-A: 检查网络、使用 VPN
+**Q: Network timeout?**
+A: Check network, use VPN
 
-**Q: 文件保存在哪？**  
+**Q: Where are files saved?**
 A: `~/Desktop/AppCask Downloads/`
 
 ---
 
-## 🎯 路线图
+## 🎯 Roadmap
 
-- [ ] macOS App Store 支持
-- [ ] 应用评论下载
-- [ ] 批量下载模式
-- [ ] Web 界面
+- [ ] macOS App Store support
+- [ ] App reviews download
+- [ ] Batch download mode
+- [ ] Web interface
 
 ---
 
-## 📄 许可证
+## 📄 License
 
 MIT License
 
 ---
 
-## 📮 联系
+## 📮 Contact
 
 - GitHub: [@yourusername](https://github.com/yourusername)
-- Issues: [反馈问题](https://github.com/yourusername/appcask/issues)
+- Issues: [Feedback issues](https://github.com/yourusername/appcask/issues)
 
 ---
 

data/examples/batch_download.rb

@@ -1,26 +1,28 @@
 #!/usr/bin/env ruby
+# frozen_string_literal: true
+
 # AppCask batch download example
 # Usage: ruby examples/batch_download.rb
 
-require 'appcask'
+require "appcask"
 
 # Define the list of apps to download
 apps = [
-  { name: 'Instagram', region: 'us', description: 'Social media app' },
-  { name: 'Twitter',   region: 'us', description: 'Microblogging platform' },
-  { name: 'WeChat',    region: 'cn', description: 'Instant messaging app' },
-  { name: 'LINE',      region: 'jp', description: 'Messaging app popular in Japan' },
-  { name: 'KakaoTalk', region: 'kr', description: 'Messaging app popular in Korea' }
+  { name: "Instagram", region: "us", description: "Social media app" },
+  { name: "Twitter",   region: "us", description: "Microblogging platform" },
+  { name: "WeChat",    region: "cn", description: "Instant messaging app" },
+  { name: "LINE",      region: "jp", description: "Messaging app popular in Japan" },
+  { name: "KakaoTalk", region: "kr", description: "Messaging app popular in Korea" }
 ]
 
-puts '=' * 50
-puts 'AppCask Batch Download Script'
-puts '=' * 50
+puts "=" * 50
+puts "AppCask Batch Download Script"
+puts "=" * 50
 puts "\nPreparing to download resources for #{apps.size} apps...\n\n"
 
 apps.each_with_index do |app, index|
   puts "\n[#{index + 1}/#{apps.size}] Processing: #{app[:name]} (#{app[:description]})"
-  puts '-' * 50
+  puts "-" * 50
 
   # Set command-line arguments
   ARGV.clear
@@ -38,6 +40,6 @@ apps.each_with_index do |app, index|
   sleep 2 unless index == apps.size - 1
 end
 
-puts "\n" + '=' * 50
-puts 'Batch download completed!'
-puts '=' * 50
+puts "\n#{"=" * 50}"
+puts "Batch download completed!"
+puts "=" * 50

data/exe/appcask

@@ -1,5 +1,6 @@
 #!/usr/bin/env ruby
+# frozen_string_literal: true
 
 require "appcask"
 
-AppCask.main
+AppCask.main

data/lib/appcask/local_app.rb

@@ -0,0 +1,139 @@
+# frozen_string_literal: true
+
+require "cfpropertylist"
+require "icns"
+require "mini_magick"
+require "fileutils"
+
+module AppCask
+  class LocalApp
+    APPS_DIR = "/Applications"
+    OUTPUT_BASE = File.join(Dir.home, "Desktop", "AppCask Downloads", "Local Apps")
+
+    class << self
+      def fetch_all
+        puts "\nFetching local app icons..."
+        puts "Source: #{APPS_DIR}"
+        puts "Output: #{OUTPUT_BASE}\n\n"
+
+        FileUtils.mkdir_p(OUTPUT_BASE)
+
+        apps = Dir.glob(File.join(APPS_DIR, "*.app"))
+        total = apps.count
+        success = 0
+        skipped = 0
+
+        apps.each_with_index do |app_path, index|
+          app_name = File.basename(app_path, ".app")
+          print "\r[#{index + 1}/#{total}] Processing: #{app_name.ljust(30)}"
+
+          result = extract_icon(app_path)
+          if result
+            success += 1
+          else
+            skipped += 1
+          end
+        end
+
+        puts "\n\n#{"=" * 50}"
+        puts "Done!"
+        puts "  Total apps: #{total}"
+        puts "  Extracted: #{success}"
+        puts "  Skipped: #{skipped}"
+        puts "  Output: #{OUTPUT_BASE}"
+        puts "=" * 50
+
+        # Open folder on macOS
+        return unless RUBY_PLATFORM.include?("darwin")
+
+        print "\nOpen the folder? (y/n): "
+        response = $stdin.gets
+        system("open '#{OUTPUT_BASE}'") if response&.strip&.downcase == "y"
+      end
+
+      private
+
+      def extract_icon(app_path)
+        # 1. Read Info.plist
+        plist_path = File.join(app_path, "Contents", "Info.plist")
+        return nil unless File.exist?(plist_path)
+
+        plist = CFPropertyList::List.new(file: plist_path)
+        info = CFPropertyList.native_types(plist.value)
+
+        # 2. Get icon file name
+        icon_name = info["CFBundleTypeIconFile"] || info["CFBundleIconFile"] || info["CFBundleIconName"]
+        return nil unless icon_name
+
+        icon_name += ".icns" unless icon_name.end_with?(".icns")
+
+        # 3. Find .icns file
+        icns_path = File.join(app_path, "Contents", "Resources", icon_name)
+        return nil unless File.exist?(icns_path)
+
+        # 4. Parse .icns and extract largest PNG
+        reader = Icns::Reader.new(icns_path)
+
+        # Priority: 1024 → 512 → 256 → 128
+        [1024, 512, 256, 128].each do |size|
+          data = reader.image(size: size)
+          next unless data
+          next unless png?(data)
+
+          # 5. Save as 512x512 PNG
+          output_path = output_path(app_path)
+          save_as_512(data, size, output_path)
+          return output_path
+        end
+
+        nil
+      rescue StandardError
+        nil
+      end
+
+      def png?(data)
+        png_magic = [0x89, 0x50, 0x4e, 0x47].pack("C4")
+        data[0..3] == png_magic
+      end
+
+      def save_as_512(data, original_size, output_path)
+        if original_size == 512
+          # Direct write
+          File.write(output_path, data)
+        else
+          # Need to resize - use mini_magick
+          resize_with_mini_magick(data, output_path)
+        end
+      end
+
+      def resize_with_mini_magick(data, output_path)
+        # Write to temp file, resize, then save
+        tmp_input = File.join(Dir.tmpdir, "appcask_input_#{Process.pid}.png")
+        tmp_output = File.join(Dir.tmpdir, "appcask_output_#{Process.pid}.png")
+
+        File.write(tmp_input, data)
+
+        image = MiniMagick::Image.new(tmp_input)
+        image.resize "512x512"
+        image.format "png"
+        image.write(tmp_output)
+
+        FileUtils.cp(tmp_output, output_path)
+      ensure
+        FileUtils.rm_f(tmp_input) if tmp_input
+        FileUtils.rm_f(tmp_output) if tmp_output
+      end
+
+      def output_path(app_path)
+        app_name = File.basename(app_path, ".app")
+        filename = "#{sanitize_app_name(app_name)}.png"
+        File.join(OUTPUT_BASE, filename)
+      end
+
+      def sanitize_app_name(name)
+        # Keep Chinese characters, convert to lowercase, replace spaces with hyphens
+        name.downcase.gsub(/\s+/, "-").gsub(/[^a-z0-9\u4e00-\u9fff-]/, "").gsub(/^-|-$/, "")
+      end
+    end
+  end
+end

data/lib/appcask/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module AppCask
-  VERSION = "0.4.0"
+  VERSION = "0.6.0"
 end