app-info 2.8.2 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a3da34af686efd6aacd4b80fbb8b49a9c1dd38f101075a4950214ef3bc83314b
-  data.tar.gz: 0c0359085eca517924e26b89e649ce6ae42683532676dc0f14613daccab3686b
+  metadata.gz: 77ca2c693d75ac261a17cb20e06e643a5de75a4d9eb15b1b5f83a151780368df
+  data.tar.gz: e9d70889b047b04b60f50a70a20d9651145486c855e059999a8037828e53e9a6
 SHA512:
-  metadata.gz: d9fa46b089aae06843662fd5f5780012f34b0913a231183e18a7a8bdec227012069c1e0d11ae613460f7b5b73cd76c7039e46e85215b6d103360be9d05391bd6
-  data.tar.gz: a2f9e51a8180b6baac585fd5f5e02528ddd46063477e1fcb3738967e0738b56aab902096694483c834473f17cf3e229d4241a62351297c76243383979b61da4b
+  metadata.gz: c186bac4cab303067045830362c0f95deefc7c2488375f8dcb2113ea1bbc019982d645f4a29c44ab946e55c238c7e4820d0f9c1f443346143f4ed4183ebcaf32
+  data.tar.gz: 3755af0041ef4068a6e28399d77c17744fe7f76cf321aca94e719b19fcf1357ad64a06a63b191a9960a347423d874355dfda6995208a0ae992769de5635e2582

data/.github/dependabot.yml

@@ -1,9 +1,14 @@
 version: 2
 updates:
-- package-ecosystem: bundler
-  directory: "/"
-  schedule:
-    interval: daily
-    time: "21:00"
-    timezone: Asia/Shanghai
-  open-pull-requests-limit: 10
+  - package-ecosystem: bundler
+    directory: "/"
+    schedule:
+      interval: daily
+      time: "21:00"
+      timezone: Asia/Shanghai
+    open-pull-requests-limit: 10
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "daily"

data/.github/workflows/ci.yml

@@ -1,8 +1,10 @@
 name: CI
 on:
   push:
+    paths-ignore:
+      - '*.md'
     branches:
-      - master
+      - main
   pull_request:
 
 jobs:
@@ -12,11 +14,11 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        ruby: [ ruby-2.5, ruby-2.6, ruby-2.7, ruby-3.0 ]
+        ruby: [ ruby-2.5, ruby-2.6, ruby-2.7, ruby-3.0, ruby-3.1, ruby-3.2 ]
         os: [ ubuntu-latest ]
 
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v3
 
       - uses: ruby/setup-ruby@v1
         with:
@@ -30,11 +32,11 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v3
 
       - uses: ruby/setup-ruby@v1
         with:
-          ruby-version: 2.7
+          ruby-version: 3.0
           bundler-cache: true
 
       - name: bundle exec rubocop

data/.github/workflows/create_release.yml

@@ -0,0 +1,15 @@
+name: Create Release
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  create:
+    runs-on: ubuntu-latest
+    steps:
+    - name: Create Release
+      uses: softprops/action-gh-release@v1
+      if: startsWith(github.ref, 'refs/tags/')
+      with:
+        files: CHANGELOG.md

data/.rubocop.yml

@@ -27,6 +27,24 @@ AllCops:
     - 'lib/app_info/protobuf/models/*_pb.rb'
     - 'main.rb'
 
+Layout/LineLength:
+  Max: 100
+  Exclude:
+    - 'lib/app_info/helper/signatures.rb'
+    - 'lib/app_info/android/signatures/info.rb'
+    - 'lib/app_info/apk.rb'
+
+Lint/AssignmentInCondition:
+  Enabled: false
+
+Lint/UnusedMethodArgument:
+  Exclude:
+    - 'lib/app_info/file.rb'
+
+Lint/UselessAssignment:
+  Exclude:
+    - 'lib/app_info/android/signatures/v3.rb'
+
 Metrics/AbcSize:
   Max: 100
 
@@ -36,13 +54,15 @@ Metrics/BlockLength:
     - 'lib/app_info/mobile_provision.rb'
 
 Metrics/MethodLength:
-  Max: 20
+  Max: 30
   Exclude:
-    - 'lib/app_info/png_uncrush.rb'
     - 'lib/app_info/mobile_provision.rb'
+    - 'lib/app_info/android/signatures/v2.rb'
+    - 'lib/app_info/android/signatures/v3.rb'
 
-Layout/LineLength:
-  Max: 100
+Metrics/ParameterLists:
+  Exclude:
+    - 'lib/app_info/helper/signatures.rb'
 
 Metrics/ClassLength:
   CountComments: false
@@ -54,12 +74,16 @@ Metrics/CyclomaticComplexity:
 Metrics/PerceivedComplexity:
   Max: 18
 
-Lint/AssignmentInCondition:
-  Enabled: false
+Metrics/BlockNesting:
+  Exclude:
+    - 'lib/app_info/dsym.rb'
 
 Style/Documentation:
   Enabled: false
 
+Style/ClassAndModuleChildren:
+  Enabled: false
+
 Style/PerlBackrefs:
   Exclude:
     - 'lib/app_info/core_ext/string/inflector.rb'
@@ -67,10 +91,8 @@ Style/PerlBackrefs:
 Style/DocumentDynamicEvalDefinition:
   Enabled: false
 
-Metrics/BlockNesting:
-  Exclude:
-    - 'lib/app_info/dsym.rb'
-
-
 Style/SlicingWithRange:
   Enabled: false
+
+Style/ClassVars:
+  Enabled: false

data/CHANGELOG.md

@@ -9,6 +9,104 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 > List all changes before release a new version.
 
+## [3.0.0] (2023-04-18)
+
+### Added
+
+- New Windows PE format parser. [#47](https://github.com/icyleaf/app_info/pull/47)
+- Android parser add v2, v3 scheme signature support. [#55](https://github.com/icyleaf/app_info/pull/55]
+- dSYM parer accept multi dSYM target in a zip file. [#56](https://github.com/icyleaf/app_info/pull/56)
+- Better document for yardoc.
+- Android parser `.icons` method add exclude param to filter icons.
+- Add `.files` method to proguard parser.
+
+### Changed
+
+- Add `AppInfo::File` base class for all parsers.
+- Add `AppInfo::Certifiate` X509 certificate wrapped and apply in Android/MobileProvision.
+- Re-organize categories `.platform`  to `.manufacturer`, `.platform` and `.device` for all parsers.
+- Remove `.sign_version` method in Android parser.
+- Rename `.file_type` to `.format` method in all parers and return a `AppInfo::Format` type.
+- Remove duplice `AppInfo::AndroidDevice` class.
+- Remove `AppInfo::MobileProvision::DeveloperCertificate` class, use `AppInfo::Certifiate` instead.
+- Deprecate `.signs` and `.certifiates` methods in Android parser, use `.signatures` instead.
+- Deprecate `.developer_certs` method in MobileProvision parser, use `.certificates` instead.
+- Change ExportType values type to symbol both IPA and macOS parsers. [#58](https://github.com/icyleaf/app_info/pull/58)
+
+## [3.0.0.beta4] (2023-04-11)
+
+### Added
+
+- Add `.files` method to proguard parser.
+
+### Fixed
+
+- Fail to extract dsym contents.
+
+## [3.0.0.beta3] (2023-04-05)
+
+### Added
+
+- Android parser `.icons` method add exclude param to filter icons.
+
+### Changed
+
+- Rename `.platform` to `.manufacturer`, rename `.opera_sytem` to `.platform` for all parsers.
+
+### Fixed
+
+- Minor fixes.
+
+## [3.0.0.beta2] (2023-04-04)
+
+### Changed
+
+- Re-organize categories `.platform`, `.opera_sytem` and `.device` for all parsers. [#58](https://github.com/icyleaf/app_info/pull/58)
+- Change ExportType values type to symbol both IPA and macOS parsers. [#58](https://github.com/icyleaf/app_info/pull/58)
+
+## [3.0.0.beta1] (2023-04-04)
+
+### Added
+
+- New Windows PE format parser. [#47](https://github.com/icyleaf/app_info/pull/47)
+- Android parser add v2, v3 scheme signature support. [#55](https://github.com/icyleaf/app_info/pull/55]
+- dSYM parer accept multi dSYM target in a zip file. [#56](https://github.com/icyleaf/app_info/pull/56)
+- Better document for yardoc.
+
+### Changed
+
+- Add `AppInfo::File` base class for all parsers.
+- Add `AppInfo::Certifiate` X509 certificate wrapped and apply in Android/MobileProvision.
+- Remove `.sign_version` method in Android parser.
+- Rename `.file_type` to `.format` method in all parers and return a `AppInfo::Format` type.
+- Remove duplice `AppInfo::AndroidDevice` class.
+- Remove `AppInfo::MobileProvision::DeveloperCertificate` class, use `AppInfo::Certifiate` instead.
+- Deprecate `.signs` and `.certifiates` methods in Android parser, use `.signatures` instead.
+- Deprecate `.developer_certs` method in MobileProvision parser, use `.certificates` instead.
+
+### Fixed
+
+- Fixed minor typo.
+
+## [2.8.5] (2023-03-16)
+
+### Fixed
+
+- Sync the latest appt2 proto files to parse Android SDK 31+ for aab parser. [#51](https://github.com/icyleaf/app_info/issues/51) (thanks @[UpBra](https://github.com/UpBra))
+
+## [2.8.4] (2023-03-09)
+
+### Fixed
+
+- Force android device return as boolean for aab parser.
+- Handle string resources referencing other resources for apk parser.
+
+## [2.8.3] (2022-06-27)
+
+### Fixed
+
+- Fix properties in `AndroidManifest.xml` of aab file with null state prediction.
+
 ## [2.8.2] (2022-02-13)
 
 ### Fixed
@@ -228,7 +326,15 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 - Updated dependency of CFPropertly list be a range between 2.3.4. (thanks @[cschroed](https://github.com/cschroed))
 
-[Unreleased]: https://github.com/icyleaf/app-info/compare/v2.8.2..HEAD
+[Unreleased]: https://github.com/icyleaf/app-info/compare/v3.0.0..HEAD
+[3.0.0]: https://github.com/icyleaf/app-info/compare/v2.8.5...v3.0.0
+[3.0.0.beta4]: https://github.com/icyleaf/app-info/compare/v3.0.0.beta3...v3.0.0.beta4
+[3.0.0.beta3]: https://github.com/icyleaf/app-info/compare/v3.0.0.beta2...v3.0.0.beta3
+[3.0.0.beta2]: https://github.com/icyleaf/app-info/compare/v3.0.0.beta1...v3.0.0.beta2
+[3.0.0.beta1]: https://github.com/icyleaf/app-info/compare/v2.8.5...v3.0.0.beta1
+[2.8.5]: https://github.com/icyleaf/app-info/compare/v2.8.4...v2.8.5
+[2.8.4]: https://github.com/icyleaf/app-info/compare/v2.8.3...v2.8.4
+[2.8.3]: https://github.com/icyleaf/app-info/compare/v2.8.2...v2.8.3
 [2.8.2]: https://github.com/icyleaf/app-info/compare/v2.8.1...v2.8.2
 [2.8.1]: https://github.com/icyleaf/app-info/compare/v2.8.0...v2.8.1
 [2.8.0]: https://github.com/icyleaf/app-info/compare/v2.7.0...v2.8.0

data/Gemfile

@@ -5,8 +5,13 @@ source 'https://rubygems.org'
 # Specify your gem's dependencies in app-info.gemspec
 gemspec
 
-# group :development do
-#   gem 'awesome_print'
-#   gem 'debase'
-#   gem 'ruby-debug-ide'
-# end
+group :development do
+  gem 'awesome_print'
+  gem 'debug' # For ruby 3.0+\
+  gem 'yard'
+end
+
+group :development, :test do
+  gem 'rspec'
+  gem 'rubocop'
+end

data/README.md

@@ -1,22 +1,38 @@
-# app_info
+# app-info
 
-[![Language](https://img.shields.io/badge/ruby-2.5+-701516.svg)](.github/workflows/ci.yml)
-[![Build Status](https://img.shields.io/github/workflow/status/icyleaf/app_info/CI)](https://github.com/icyleaf/app_info/actions/workflows/ci.yml)
-[![Gem version](https://img.shields.io/gem/v/app-info.svg?style=flat)](https://rubygems.org/gems/app_info)
-[![License](https://img.shields.io/badge/license-MIT-red.svg?style=flat)](LICENSE)
+[![Language](https://img.shields.io/badge/ruby-2.5+-701516)](.github/workflows/ci.yml)
+[![Gem version](https://img.shields.io/gem/v/app-info?include_prereleases)](https://rubygems.org/gems/app-info)
+[![Build Status](https://img.shields.io/github/actions/workflow/status/icyleaf/app_info/ci.yml)](https://github.com/icyleaf/app_info/actions/workflows/ci.yml)
+[![License](https://img.shields.io/github/license/icyleaf/app-info)](LICENSE)
 
-Teardown tool for mobile app (ipa, apk and aab file), macOS app and dSYM.zip file, analysis metedata like version, name, icon etc.
+Teardown tool for mobile app (ipa, apk and aab file), macOS app, dSYM.zip file and Windows PE file.
+Analysis metedata like version, name, icon etc.
 
 ## Support
 
 - Android file
   - `.apk`
   - `.aab` (Androld App Bundle)
-- iOS ipa file
+- iOS file
+  - `.ipa`
   - `Info.plist` file
   - `.mobileprovision`/`.provisionprofile` file
-- Zipped macOS App file
-- Zipped dSYMs file
+- macOS App file (archived by starnd pkzip format)
+  - `.app.zip`
+- dSYMs file (archived by starnd pkzip format)
+  - `.dSYM.zip`
+- Windows PE file
+  - `.exe`
+  - `.zip` (binary in a zip file)
+
+<hr />
+
+![Zealot Showcase](https://github.com/tryzealot/docs/blob/main/static/img/showcase-light.png#gh-light-mode-only)
+![Zealot Showcase](https://github.com/tryzealot/docs/blob/main/static/img/showcase-dark.png#gh-dark-mode-only)
+
+[Zealot](https://zealot.ews.im/docs/user-guide/) is a self-hosted Beta App Distribution for Android, iOS and macOS apps. app_info it the core inside.
+
+<hr />
 
 ## Installation
 
@@ -53,6 +69,8 @@ parser = AppInfo.parse('android.aab')
 parser = AppInfo.parse('u-u-i-d.mobileprovision')
 parser = AppInfo.parse('macOS.App.zip')
 parser = AppInfo.parse('App.dSYm.zip')
+parser = AppInfo.parse('win.exe')
+parser = AppInfo.parse('win.zip')
 
 # If detect file type failed, you can parse in other way
 parser = AppInfo::IPA.new('iphone.ipa')
@@ -62,6 +80,7 @@ parser = AppInfo::InfoPlist.new('Info.plist')
 parser = AppInfo::MobileProvision.new('uuid.mobileprovision')
 parser = AppInfo::Macos.new('App.dSYm.zip')
 parser = AppInfo::DSYM.new('App.dSYm.zip')
+parser = AppInfo::PE.new('win.exe')
 ```
 
 ### iOS
@@ -208,12 +227,8 @@ android.deep_links
 android.schemes
 # => ['appinfo']
 
-# get sign list (only v1 sign)
-android.signs
-# => [...]
-
-# get certificate list (only v1 sign)
-android.certificates
+# get v1-v3 scheme singature information (included unverified certificate and more)
+android.signatures
 # => [...]
 ```
 
@@ -301,6 +316,58 @@ dsym.machos.each do |macho|
 end
 ```
 
+### Windows
+
+Accept any PE format file, such like `.exe` or `.exe` binary fin a zip file.
+
+```ruby
+win = AppInfo.parse('win.exe')
+
+# get given file size
+win.size
+# => 3093823
+
+# get given file size in human reable.
+win.size(human_size: true)
+# => 29 MB
+
+# get given file size
+win.binary_size
+# => 20940
+
+# get given file size in human reable.
+win.size(human_size: true)
+# => 20 MB
+
+# get product name
+win.name
+# => AppInfo
+
+# get app company name
+win.company_name
+# => EWS Studio
+
+# get app product version (alias to release_version)
+win.product_version
+# => 1.0.0
+
+# get app assembly version (alias to build_version)
+win.assembly_version
+# => 1.0.0
+
+# detect architecture(s)
+win.archs
+# => x64
+
+# get all imports files
+win.imports
+# => [KERNEL32.dll, ...]
+
+# get app icons (bmp format image)
+win.icons
+# => [{:name=>"ICON.bmp", :file=>"{path}/ICON.bmp"}, :dimensions=>[64, 64]}, ...]
+```
+
 ## CLI Shell (Interactive console)
 
 It is possible to use this gem as a command line interface to parse mobile app:

data/Rakefile

@@ -2,6 +2,7 @@
 
 $LOAD_PATH.unshift File.expand_path('lib', __dir__)
 require 'app_info'
+require 'yard'
 require 'bundler/gem_tasks'
 require 'rspec/core/rake_task'
 require 'rubocop/rake_task'
@@ -9,3 +10,13 @@ require 'rubocop/rake_task'
 RSpec::Core::RakeTask.new(:spec)
 
 task default: :spec
+
+task :doc do
+  YARD::Rake::YardocTask.new do |t|
+    t.files   = ['lib/**/*.rb', 'README.md', 'LICENSE']
+    # t.options = ['--any', '--extra', '--opts'] # optional
+    # t.stats_options = ['--list-undoc']         # optional
+  end
+end
+
+

data/app_info.gemspec

@@ -21,16 +21,25 @@ Gem::Specification.new do |spec|
   spec.required_ruby_version = '>= 2.5'
 
   spec.add_dependency 'CFPropertyList', '< 3.1.0', '>= 2.3.4'
-  spec.add_dependency 'image_size', '>= 1.5', '< 3.1'
+  spec.add_dependency 'image_size', '>= 1.5', '< 3.3'
   spec.add_dependency 'ruby-macho', '>= 1.4', '< 4'
-  spec.add_dependency 'android_parser', '~> 2.5.0'
+  spec.add_dependency 'android_parser', '~> 2.6.0'
   spec.add_dependency 'rubyzip', '>= 1.2', '< 3.0'
   spec.add_dependency 'uuidtools', '>= 2.1.5', '< 2.3.0'
   spec.add_dependency 'icns', '~> 0.2.0'
-  spec.add_dependency 'google-protobuf', '~> 3.19.4'
+  spec.add_dependency 'pedump', '~> 0.6.2'
+  spec.add_dependency 'google-protobuf', '>= 3.19.4', '< 3.23.0'
 
   spec.add_development_dependency 'bundler', '>= 1.12'
   spec.add_development_dependency 'rake', '>= 10.0'
-  spec.add_development_dependency 'rspec', '~> 3.0'
-  spec.add_development_dependency 'rubocop', '~> 1.19'
+
+  spec.post_install_message = <<~ENDBANNER
+    AppInfo 3.0 is coming!
+    **********************
+    The public API of some AppInfo classes has been changed.
+
+    Please ensure that your Gemfiles and .gemspecs are suitably restrictive
+    to avoid an unexpected breakage when 3.0 is released (e.g. ~> 2.8.5).
+    See https://github.com/icyleaf/app_info for details.
+  ENDBANNER
 end