appcask 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 84b4342166055f34caca13c015782050cc53a3b822def01f171d5b7a3b46cfd6
-  data.tar.gz: 2d3a8ae4795e748adcc170cb9a718604fe121b1342a87dc562a6c7cf7db62ad2
+  metadata.gz: d9bd75bdfd4ad953034b8c138d77182dad7b6ce42574b5759de17c47112a0f40
+  data.tar.gz: 3965bdb3ce67b2b05ec839b6b10e8483ad39512f516f1ef9f51b8ed84d6753c7
 SHA512:
-  metadata.gz: d352aaccc7f028d535de981d1381d924f9e01c572cd5ccebd37950ce645625f22c2b38cd0eb0aa75cc8c6fbaec0b930d6659e3e0e0438323b1af8a86460f1685
-  data.tar.gz: e7f972f9abfafb77b5e8bb62af302b51eb61e3e0702a08979941265f7a52d7dda260a848c6d2eca8448d4bfd5fa7d5ec207c2b4ebe60e43bf74c89a06f41ab00
+  metadata.gz: 64ac79508b09554074b746bdb19e3fd93e395ca31fc814ba75aa6a2ca9ad37342185f196afc5e078a14d15e6bb0a21195f1a5afc702769315abe7c1b5e619679
+  data.tar.gz: f0dbf33f39841824842988acf02d9f10f004dc52069daa85108504faf1c91c5ec98a983a338161ac1ef2b9ff1fcd5e109556cf48f1082cc494edd24b9dd9d367

data/.idea/appcask.iml

@@ -0,0 +1,47 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="RUBY_MODULE" version="4">
+  <component name="ModuleRunConfigurationManager">
+    <shared />
+  </component>
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$">
+      <sourceFolder url="file://$MODULE_DIR$/features" isTestSource="true" />
+      <sourceFolder url="file://$MODULE_DIR$/spec" isTestSource="true" />
+      <sourceFolder url="file://$MODULE_DIR$/test" isTestSource="true" />
+    </content>
+    <orderEntry type="jdk" jdkName="mise: 4.0.0" jdkType="RUBY_SDK" />
+    <orderEntry type="sourceFolder" forTests="false" />
+    <orderEntry type="library" scope="PROVIDED" name="ansi (v1.5.0, mise: 4.0.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="ast (v2.4.3, mise: 4.0.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="builder (v3.3.0, mise: 4.0.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="bundler (v4.0.3, mise: 4.0.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="date (v3.5.1, mise: 4.0.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="erb (v6.0.1, mise: 4.0.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="io-console (v0.8.2, mise: 4.0.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="irb (v1.16.0, mise: 4.0.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="json (v2.18.0, mise: 4.0.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="language_server-protocol (v3.17.0.5, mise: 4.0.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="lint_roller (v1.1.0, mise: 4.0.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="minitest (v5.27.0, mise: 4.0.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="minitest-reporters (v1.7.1, mise: 4.0.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="parallel (v1.27.0, mise: 4.0.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="parser (v3.3.10.1, mise: 4.0.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="pp (v0.6.3, mise: 4.0.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="prettyprint (v0.2.0, mise: 4.0.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="prism (v1.9.0, mise: 4.0.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="psych (v5.3.1, mise: 4.0.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="racc (v1.8.1, mise: 4.0.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rainbow (v3.1.1, mise: 4.0.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rake (v13.3.1, mise: 4.0.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rdoc (v7.1.0, mise: 4.0.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="regexp_parser (v2.11.3, mise: 4.0.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="reline (v0.6.3, mise: 4.0.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rubocop (v1.84.0, mise: 4.0.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rubocop-ast (v1.49.0, mise: 4.0.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="ruby-progressbar (v1.13.0, mise: 4.0.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="stringio (v3.2.0, mise: 4.0.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="tsort (v0.2.0, mise: 4.0.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="unicode-display_width (v3.2.0, mise: 4.0.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="unicode-emoji (v4.2.0, mise: 4.0.0) [gem]" level="application" />
+  </component>
+</module>

data/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/appcask.iml" filepath="$PROJECT_DIR$/.idea/appcask.iml" />
+    </modules>
+  </component>
+</project>

data/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="" vcs="Git" />
+  </component>
+</project>

data/.idea/workspace.xml

@@ -5,25 +5,11 @@
   </component>
   <component name="ChangeListManager">
     <list default="true" id="1bd4c817-c426-471c-bdf5-e80649db2ae2" name="更改" comment="">
-      <change afterPath="$PROJECT_DIR$/.github/workflows/main.yml" afterDir="false" />
-      <change afterPath="$PROJECT_DIR$/.gitignore" afterDir="false" />
-      <change afterPath="$PROJECT_DIR$/.idea/workspace.xml" afterDir="false" />
-      <change afterPath="$PROJECT_DIR$/.rubocop.yml" afterDir="false" />
-      <change afterPath="$PROJECT_DIR$/CHANGELOG.md" afterDir="false" />
-      <change afterPath="$PROJECT_DIR$/CODE_OF_CONDUCT.md" afterDir="false" />
-      <change afterPath="$PROJECT_DIR$/Gemfile" afterDir="false" />
-      <change afterPath="$PROJECT_DIR$/LICENSE.txt" afterDir="false" />
-      <change afterPath="$PROJECT_DIR$/README.md" afterDir="false" />
-      <change afterPath="$PROJECT_DIR$/Rakefile" afterDir="false" />
-      <change afterPath="$PROJECT_DIR$/appcask.gemspec" afterDir="false" />
-      <change afterPath="$PROJECT_DIR$/bin/console" afterDir="false" />
-      <change afterPath="$PROJECT_DIR$/bin/setup" afterDir="false" />
-      <change afterPath="$PROJECT_DIR$/examples/batch_download.rb" afterDir="false" />
-      <change afterPath="$PROJECT_DIR$/lib/appcask.rb" afterDir="false" />
-      <change afterPath="$PROJECT_DIR$/lib/appcask/version.rb" afterDir="false" />
-      <change afterPath="$PROJECT_DIR$/sig/appcask.rbs" afterDir="false" />
-      <change afterPath="$PROJECT_DIR$/test/test_appcask.rb" afterDir="false" />
-      <change afterPath="$PROJECT_DIR$/test/test_helper.rb" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/.idea/appcask.iml" beforeDir="false" afterPath="$PROJECT_DIR$/.idea/appcask.iml" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/.idea/workspace.xml" beforeDir="false" afterPath="$PROJECT_DIR$/.idea/workspace.xml" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/Gemfile.lock" beforeDir="false" afterPath="$PROJECT_DIR$/Gemfile.lock" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/appcask.gemspec" beforeDir="false" afterPath="$PROJECT_DIR$/appcask.gemspec" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/lib/appcask/version.rb" beforeDir="false" afterPath="$PROJECT_DIR$/lib/appcask/version.rb" afterDir="false" />
     </list>
     <option name="SHOW_DIALOG" value="false" />
     <option name="HIGHLIGHT_CONFLICTS" value="true" />
@@ -33,9 +19,9 @@
   <component name="Git.Settings">
     <option name="RECENT_GIT_ROOT_PATH" value="$PROJECT_DIR$" />
   </component>
-  <component name="ProjectColorInfo"><![CDATA[{
-  "associatedIndex": 3
-}]]></component>
+  <component name="ProjectColorInfo">{
+  &quot;associatedIndex&quot;: 3
+}</component>
   <component name="ProjectId" id="38w4u8bpa7evnl9Tft1pg9mpNsJ" />
   <component name="ProjectViewState">
     <option name="hideEmptyMiddlePackages" value="true" />
@@ -49,6 +35,7 @@
     "RunOnceActivity.TerminalTabsStorage.copyFrom.TerminalArrangementManager.252": "true",
     "RunOnceActivity.git.unshallow": "true",
     "RunOnceActivity.typescript.service.memoryLimit.init": "true",
+    "com.intellij.lang.ruby.rbs.tools.collection.workspace.sync.RbsCollectionUpdateProjectActivity#LAST_UPDATE_TIMESTAMP": "1769702888715",
     "git-widget-placeholder": "main",
     "node.js.detected.package.eslint": "true",
     "node.js.detected.package.tslint": "true",
@@ -76,11 +63,16 @@
       <option name="presentableId" value="Default" />
       <updated>1767270112011</updated>
       <workItem from="1767270116395" duration="20000" />
-      <workItem from="1769697520161" duration="3786000" />
+      <workItem from="1769697520161" duration="4958000" />
+      <workItem from="1769702829159" duration="260000" />
     </task>
     <servers />
   </component>
   <component name="TypeScriptGeneratedFilesManager">
     <option name="version" value="3" />
   </component>
+  <component name="VcsManagerConfiguration">
+    <MESSAGE value="first commit" />
+    <option name="LAST_COMMIT_MESSAGE" value="first commit" />
+  </component>
 </project>

data/QUICKSTART.md

@@ -0,0 +1,224 @@
+# AppCask 快速入门指南
+
+## 欢迎使用 AppCask! 🎉
+
+AppCask 是一个强大的命令行工具，可以帮你下载 App Store 应用的各种资源。
+
+## 5分钟快速上手
+
+### 1️⃣ 安装
+
+```bash
+gem install appcask
+```
+
+### 2️⃣ 第一次使用
+
+最简单的方式 - 直接运行:
+
+```bash
+appcask
+```
+
+然后按照提示操作即可！
+
+### 3️⃣ 快速搜索
+
+如果你知道要找什么应用:
+
+```bash
+appcask "Instagram"
+```
+
+### 4️⃣ 选择下载内容
+
+运行后，你会看到 4 个选项:
+
+```
+[1] 图标          - 下载应用图标（4种尺寸）
+[2] 截图          - 下载应用截图（iPhone和iPad）
+[3] 简介信息      - 导出应用详细信息
+[4] 完整包        - 一次下载所有内容
+```
+
+推荐新手选择 **[4] 完整包**，一次获取所有资源！
+
+## 常用场景
+
+### 场景1: 我想要应用的高清图标
+
+```bash
+appcask "应用名称"
+# 选择 [1] 图标
+# 选择 [3] 1024x1024
+```
+
+### 场景2: 我需要应用的所有截图
+
+```bash
+appcask "应用名称"
+# 选择 [2] 截图
+# 选择 all (下载所有设备的截图)
+```
+
+### 场景3: 我要做应用分析，需要详细信息
+
+```bash
+appcask "应用名称"
+# 选择 [3] 简介信息
+# 会生成 3 个文件: TXT, JSON, Markdown
+```
+
+### 场景4: 我什么都要！
+
+```bash
+appcask "应用名称"
+# 选择 [4] 完整包
+# 一次性下载图标、截图、信息
+```
+
+## 下载的文件在哪里？
+
+默认保存位置:
+
+```
+~/Desktop/AppCask Downloads/应用名称/
+```
+
+目录结构:
+
+```
+Instagram/
+├── icons/              # 所有尺寸的图标
+├── screenshots/        # 按设备分类的截图
+│   ├── iPhone/
+│   └── iPad/
+├── app_info.txt       # 文本格式信息
+├── app_info.json      # JSON格式信息
+└── README.md          # Markdown格式文档
+```
+
+## 搜索其他国家的 App Store
+
+AppCask 支持 9 个国家/地区:
+
+```bash
+# 搜索中国区
+appcask "微信" cn
+
+# 搜索日本区
+appcask "Line" jp
+
+# 搜索韩国区
+appcask "KakaoTalk" kr
+```
+
+支持的区域代码:
+- `us` - 🇺🇸 美国
+- `cn` - 🇨🇳 中国
+- `jp` - 🇯🇵 日本
+- `kr` - 🇰🇷 韩国
+- `hk` - 🇭🇰 香港
+- `tw` - 🇹🇼 台湾
+- `gb` - 🇬🇧 英国
+- `de` - 🇩🇪 德国
+- `fr` - 🇫🇷 法国
+
+## 快捷键
+
+- **回车** - 使用默认选项
+- **q** - 退出当前步骤
+- **Ctrl+C** - 安全退出程序
+
+## 实用技巧
+
+### 技巧1: 批量下载
+
+创建一个文本文件 `apps.txt`:
+
+```
+Instagram
+Twitter
+Facebook
+TikTok
+```
+
+然后运行:
+
+```bash
+while read app; do
+  appcask "$app"
+  sleep 2
+done < apps.txt
+```
+
+### 技巧2: 只看不下载
+
+想看看有哪些信息但不下载？按 `q` 随时退出！
+
+### 技巧3: macOS 用户专属
+
+下载完成后，选择 `y` 直接打开文件夹:
+
+```
+是否打开文件夹? (y/n): y
+```
+
+## 遇到问题？
+
+### 问题1: 找不到应用
+
+✅ 解决方法:
+- 检查拼写
+- 尝试用英文名搜索
+- 切换不同区域
+
+### 问题2: 网络超时
+
+✅ 解决方法:
+- 检查网络连接
+- 使用 VPN
+- 稍后重试
+
+### 问题3: 下载失败
+
+✅ 解决方法:
+
+```bash
+DEBUG=1 appcask "应用名称"
+```
+
+这会显示详细的错误信息，方便排查问题。
+
+## 下一步
+
+### 了解更多功能
+
+查看完整文档:
+
+```bash
+# 如果安装了 gem
+gem help appcask
+```
+
+或访问 GitHub 仓库查看 README.md
+
+### 升级到最新版
+
+```bash
+gem update appcask
+```
+
+### 分享你的使用经验
+
+觉得好用？给项目点个 Star ⭐
+
+有问题？提交 Issue 📝
+
+有建议？发起 Pull Request 🚀
+
+## 最后
+
+享受使用 AppCask！如有任何问题，欢迎反馈。
+
+Happy downloading! 🎊

data/bin/console

@@ -0,0 +1,11 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "appcask"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/exe/appcask

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require "appcask"
+
+AppCask.main

data/lib/appcask/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Appcask
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,57 +1,37 @@
 --- !ruby/object:Gem::Specification
 name: appcask
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Billow Wang
 bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
-dependencies:
-- !ruby/object:Gem::Dependency
-  name: json
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: net-http
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
+dependencies: []
 description: AppCask is a CLI tool for downloading App Store icons, screenshots and
   metadata.
 email:
 - netheadonline@gmail.com
-executables: []
+executables:
+- appcask
 extensions: []
 extra_rdoc_files: []
 files:
+- ".idea/appcask.iml"
+- ".idea/modules.xml"
+- ".idea/vcs.xml"
 - ".idea/workspace.xml"
 - CHANGELOG.md
 - CODE_OF_CONDUCT.md
 - LICENSE.txt
+- QUICKSTART.md
 - README.md
 - Rakefile
+- bin/console
+- bin/setup
 - examples/batch_download.rb
+- exe/appcask
 - lib/appcask.rb
 - lib/appcask/version.rb
 - sig/appcask.rbs
@@ -62,7 +42,7 @@ metadata:
   allowed_push_host: https://rubygems.org/
   homepage_uri: https://github.com/gamepunk/appcask
   source_code_uri: https://github.com/gamepunk/appcask
-  changelog_uri: https://github.com/gamepunk/appcask
+  changelog_uri: https://github.com/gamepunk/appcask/blob/main/CHANGELOG.md
 rdoc_options: []
 require_paths:
 - lib