app-info 2.6.5 → 2.7.0.beta1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 79a5669bb25288b95dda6a7f02181e6375fe192234a88eb17957358590e12870
-  data.tar.gz: 73bbe25cc149955b7140105108090a5a4db0019ca1e5408358a6439f8c606599
+  metadata.gz: b37b084ef666db1fad604e2aa19698faad80d68d7d79a031c55d60e3f8b97f48
+  data.tar.gz: 2a8da24c6adc6b9f003d8a8016569f2f20772f1c7524ea411a6b4946f32fd0a7
 SHA512:
-  metadata.gz: f3ae7c2886106af7ffdbb69ab031fb7ec81b196a12ba05544e467398850d7299e2152ad24d3523b0a4d1ebd0f005dba0fcbd37f826b67aa848eece592359a01b
-  data.tar.gz: 33f09022fbaec5f95997bec8fee7a73dd4f9fe7dd85837b9541337e44330ee6fee8db5cbee975e1248433ccd2fa7f0857c82d6f67700cd498959284c0002f921
+  metadata.gz: 9041485898807902ce753c4114b82037cf900c45fc4ce183fb2af0ec57c0fd05ebe96314a89016e3f423531daa528d48d6ea566445296be045d18dc6ab4da4cb
+  data.tar.gz: fd22abedeea11ba62dd7f4575f19a08348d146cc6ffd3a6d69b54652a869b9dc095467d9922031a84d79336fbbc4e3dc485a428e8a96d66fc4bedc378d1e962f

data/.rubocop.yml

@@ -20,10 +20,12 @@ AllCops:
   Exclude:
     - 'bin/*'
     - 'spec/**/*'
-    - vendor/bundle/**/*
+    - 'vendor/bundle/**/*'
     - 'Rakefile'
     - 'app_info.gemspec'
     - 'lib/app-info.rb'
+    - 'lib/app_info/protobuf/models/*_pb.rb'
+    - 'main.rb'
 
 Metrics/AbcSize:
   Max: 100
@@ -56,4 +58,19 @@ Lint/AssignmentInCondition:
   Enabled: false
 
 Style/Documentation:
-  Enabled: false
+  Enabled: false
+
+Style/PerlBackrefs:
+  Exclude:
+    - 'lib/app_info/core_ext/string/inflector.rb'
+
+Style/DocumentDynamicEvalDefinition:
+  Enabled: false
+
+Metrics/BlockNesting:
+  Exclude:
+    - 'lib/app_info/dsym.rb'
+
+
+Style/SlicingWithRange:
+  Enabled: false

data/CHANGELOG.md

@@ -9,6 +9,12 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 > List all changes before release a new version.
 
+## [2.7.0.beta1] (2021-09-27)
+
+### Added
+
+- Android App Bundle a.k.a `aab` file parts support [#36](https://github.com/icyleaf/app_info/pull/36)
+
 ## [2.6.5] (2021-09-17)
 
 ### Added
@@ -185,7 +191,8 @@ 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.6.5..HEAD
+[Unreleased]: https://github.com/icyleaf/app-info/compare/v2.7.0.beta1..HEAD
+[2.7.0.beta1]: https://github.com/icyleaf/app-info/compare/v2.6.5...v2.7.0.beta1
 [2.6.5]: https://github.com/icyleaf/app-info/compare/v2.6.4...v2.6.5
 [2.6.4]: https://github.com/icyleaf/app-info/compare/v2.6.3...v2.6.4
 [2.6.3]: https://github.com/icyleaf/app-info/compare/v2.6.1...v2.6.3

data/README.md

@@ -9,12 +9,14 @@ Teardown tool for mobile(ipa/apk) app, macOS app and dSYM.zip file, analysis met
 
 ## Support
 
-- Android apk file
+- Android file
+  - `.apk`
+  - `.aab` (Androld App Bundle)
 - iOS ipa file
-  - Info.plist file
-  - .mobileprovision/.provisionprofile file
-- macOS App(.zip) file
-- dSYM(.zip) file
+  - `Info.plist` file
+  - `.mobileprovision`/`.provisionprofile` file
+- Zipped macOS App file
+- Zipped dSYMs file
 
 ## Installation
 
@@ -54,6 +56,7 @@ parser = AppInfo.parse('App.dSYm.zip')
 # If detect file type failed, you can parse in other way
 parser = AppInfo::IPA.new('iphone.ipa')
 parser = AppInfo::APK.new('android.apk')
+parser = AppInfo::AAB.new('android.aab')
 parser = AppInfo::InfoPlist.new('Info.plist')
 parser = AppInfo::MobileProvision.new('uuid.mobileprovision')
 parser = AppInfo::Macos.new('App.dSYm.zip')

data/app_info.gemspec

@@ -27,6 +27,7 @@ Gem::Specification.new do |spec|
   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.18.0'
 
   spec.add_development_dependency 'bundler', '>= 1.12'
   spec.add_development_dependency 'rake', '>= 10.0'

data/lib/app_info/aab.rb

@@ -0,0 +1,220 @@
+# frozen_string_literal: true
+
+require 'app_info/protobuf/manifest'
+require 'image_size'
+require 'forwardable'
+
+module AppInfo
+  # Parse APK file
+  class AAB
+    include Helper::HumanFileSize
+    extend Forwardable
+
+    attr_reader :file
+
+    # APK Devices
+    module Device
+      PHONE   = 'Phone'
+      TABLET  = 'Tablet'
+      WATCH   = 'Watch'
+      TV      = 'Television'
+    end
+
+    BASE_PATH = 'base'
+    BASE_MANIFEST = "#{BASE_PATH}/manifest/AndroidManifest.xml"
+    BASE_RESOURCES = "#{BASE_PATH}/resources.pb"
+
+    def initialize(file)
+      @file = file
+    end
+
+    def size(human_size: false)
+      file_to_human_size(@file, human_size: human_size)
+    end
+
+    def os
+      Platform::ANDROID
+    end
+    alias file_type os
+
+    def_delegators :manifest, :version_name
+
+    alias release_version version_name
+
+    def package_name
+      manifest.package
+    end
+    alias identifier package_name
+    alias bundle_id package_name
+
+    def version_code
+      manifest.version_code.to_s
+    end
+    alias build_version version_code
+
+    def name
+      manifest.label
+    end
+
+    def device_type
+      if wear?
+        Device::WATCH
+      elsif tv?
+        Device::TV
+      else
+        Device::PHONE
+      end
+    end
+
+    # TODO: find a way to detect
+    # Found answer but not works: https://stackoverflow.com/questions/9279111/determine-if-the-device-is-a-smartphone-or-tablet
+    # def tablet?
+    #   resource.first_package
+    #           .entries('bool')
+    #           .select{|e| e.name == 'isTablet' }
+    #           .size >= 1
+    # end
+
+    def wear?
+      use_features.include?('android.hardware.type.watch')
+    end
+
+    def tv?
+      use_features.include?('android.software.leanback')
+    end
+
+    def min_sdk_version
+      manifest.uses_sdk.min_sdk_version
+    end
+    alias min_os_version min_sdk_version
+
+    def target_sdk_version
+      manifest.uses_sdk.target_sdk_version
+    end
+
+    def use_features
+      @use_features ||= manifest&.uses_feature&.map(&:name)
+    end
+
+    def use_permissions
+      @use_permissions ||= manifest&.uses_permission&.map(&:name)
+    end
+
+    def activities
+      @activities ||= manifest.activities.map(&:name)
+    end
+
+    def services
+      @services ||= manifest.services.map(&:name)
+    end
+
+    def components
+      @components ||= manifest.components.transform_values do |child|
+        child.map(&:name)
+      end
+    end
+
+    def signs
+      return @signs if @signs
+
+      @signs = []
+      each_file do |path, data|
+        # find META-INF/xxx.{RSA|DSA}
+        next unless path =~ %r{^META-INF/} && data.unpack('CC') == [0x30, 0x82]
+
+        @signs << APK::Sign.new(path, OpenSSL::PKCS7.new(data))
+      end
+
+      @signs
+    end
+
+    def certificates
+      @certificates ||= signs.each_with_object([]) do |sign, obj|
+        obj << APK::Certificate.new(sign.path, sign.sign.certificates[0])
+      end
+    end
+
+    def each_file
+      zip.each do |entry|
+        next unless entry.file?
+
+        yield entry.name, @zip.read(entry)
+      end
+    end
+
+    def read_file(name, base_path: BASE_PATH)
+      content = @zip.read(entry(name, base_path: base_path))
+      return parse_binary_xml(content) if xml_file?(name)
+
+      content
+    end
+
+    def entry(name, base_path: BASE_PATH)
+      entry = @zip.find_entry(File.join(base_path, name))
+      raise NotFoundError, "'#{name}'" if entry.nil?
+
+      entry
+    end
+
+    def manifest
+      io = zip.read(zip.find_entry(BASE_MANIFEST))
+      @manifest ||= Protobuf::Manifest.parse(io, resource)
+    end
+
+    def resource
+      io = zip.read(zip.find_entry(BASE_RESOURCES))
+      @resource ||= Protobuf::Resources.parse(io)
+    end
+
+    def zip
+      @zip ||= Zip::File.open(@file)
+    end
+
+    def icons
+      @icons ||= manifest.icons.each_with_object([]) do |res, obj|
+        path = res.value
+        filename = File.basename(path)
+        filepath = File.join(contents, File.dirname(path))
+        file = File.join(filepath, filename)
+        FileUtils.mkdir_p filepath
+
+        binary_data = read_file(path)
+        File.write(file, binary_data, encoding: Encoding::BINARY)
+
+        obj << {
+          name: filename,
+          file: file,
+          dimensions: ImageSize.path(file).size
+        }
+      end
+    end
+
+    def clear!
+      return unless @contents
+
+      FileUtils.rm_rf(@contents)
+
+      @aab = nil
+      @contents = nil
+      @icons = nil
+      @app_path = nil
+      @info = nil
+    end
+
+    def contents
+      @contents ||= File.join(Dir.mktmpdir, "AppInfo-android-#{SecureRandom.hex}")
+    end
+
+    private
+
+    def xml_file?(file)
+      File.extname(file) == '.xml'
+    end
+
+    # TODO: how to convert xml content after decode protoubufed content
+    def parse_binary_xml(io)
+      io
+      # Aapt::Pb::XmlNode.decode(io)
+    end
+  end
+end

data/lib/app_info/apk.rb

@@ -7,6 +7,7 @@ require 'forwardable'
 module AppInfo
   # Parse APK file
   class APK
+    include Helper::HumanFileSize
     extend Forwardable
 
     attr_reader :file
@@ -24,11 +25,11 @@ module AppInfo
     end
 
     def size(human_size: false)
-      AppInfo::Util.file_size(@file, human_size)
+      file_to_human_size(@file, human_size: human_size)
     end
 
     def os
-      AppInfo::Platform::ANDROID
+      Platform::ANDROID
     end
     alias file_type os
 

data/lib/app_info/core_ext/string/inflector.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module AppInfo
+  module Inflector
+    def snakecase
+      gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2')
+        .gsub(/([a-z\d])([A-Z])/, '\1_\2')
+        .tr('-', '_')
+        .gsub(/\s/, '_')
+        .gsub(/__+/, '_')
+        .downcase
+    end
+
+    def camelcase(first_letter: :upper, separators: ['-', '_', '\s'])
+      str = dup
+
+      separators.each do |s|
+        str = str.gsub(/(?:#{s}+)([a-z])/) { $1.upcase }
+      end
+
+      case first_letter
+      when :upper, true
+        str = str.gsub(/(\A|\s)([a-z])/) { $1 + $2.upcase }
+      when :lower, false
+        str = str.gsub(/(\A|\s)([A-Z])/) { $1 + $2.downcase }
+      end
+
+      str
+    end
+  end
+end
+
+class String
+  include AppInfo::Inflector
+end

data/lib/app_info/core_ext.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require 'app_info/core_ext/object/try'
+require 'app_info/core_ext/string/inflector'

data/lib/app_info/dsym.rb

@@ -5,6 +5,8 @@ require 'macho'
 module AppInfo
   # DSYM parser
   class DSYM
+    include Helper::Archive
+
     attr_reader :file
 
     def initialize(file)
@@ -12,7 +14,7 @@ module AppInfo
     end
 
     def file_type
-      AppInfo::Platform::DSYM
+      Platform::DSYM
     end
 
     def object
@@ -91,7 +93,7 @@ module AppInfo
           @contents = @file
         else
           dsym_dir = nil
-          @contents = Util.unarchive(@file, path: 'dsym') do |path, zip_file|
+          @contents = unarchive(@file, path: 'dsym') do |path, zip_file|
             zip_file.each do |f|
               unless dsym_dir
                 dsym_dir = f.name
@@ -114,6 +116,8 @@ module AppInfo
 
     # DSYM Mach-O
     class MachO
+      include Helper::HumanFileSize
+
       def initialize(file, size = 0)
         @file = file
         @size = size
@@ -132,7 +136,7 @@ module AppInfo
       end
 
       def size(human_size: false)
-        return Util.size_to_human_size(@size) if human_size
+        return number_to_human_size(@size) if human_size
 
         @size
       end

data/lib/app_info/error.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require 'zip'
+require 'fileutils'
+require 'securerandom'
+
+module AppInfo
+  class Error < StandardError; end
+
+  class NotFoundError < Error; end
+
+  class UnkownFileTypeError < Error; end
+end

data/lib/app_info/helper.rb

@@ -0,0 +1,128 @@
+# frozen_string_literal: true
+
+module AppInfo
+  # App Platform
+  module Platform
+    MACOS = 'macOS'
+    IOS = 'iOS'
+    ANDROID = 'Android'
+    DSYM = 'dSYM'
+    PROGUARD = 'Proguard'
+  end
+
+  # Device Type
+  module Device
+    MACOS = 'macOS'
+    IPHONE = 'iPhone'
+    IPAD = 'iPad'
+    UNIVERSAL = 'Universal'
+  end
+
+  module AndroidDevice
+    PHONE   = 'Phone'
+    TABLET  = 'Tablet'
+    WATCH   = 'Watch'
+    TV      = 'Television'
+  end
+
+  # Icon Key
+  ICON_KEYS = {
+    Device::IPHONE => ['CFBundleIcons'],
+    Device::IPAD => ['CFBundleIcons~ipad'],
+    Device::UNIVERSAL => ['CFBundleIcons', 'CFBundleIcons~ipad'],
+    Device::MACOS => %w[CFBundleIconFile CFBundleIconName]
+  }.freeze
+
+  module Helper
+    module HumanFileSize
+      def file_to_human_size(file, human_size:)
+        number = File.size(file)
+        human_size ? number_to_human_size(number) : number
+      end
+
+      FILE_SIZE_UNITS = %w[B KB MB GB TB].freeze
+
+      def number_to_human_size(number)
+        if number.to_i < 1024
+          exponent = 0
+        else
+          max_exp = FILE_SIZE_UNITS.size - 1
+          exponent = (Math.log(number) / Math.log(1024)).to_i
+          exponent = max_exp if exponent > max_exp
+          number = format('%<number>.2f', number: (number / (1024**exponent.to_f)))
+        end
+
+        "#{number} #{FILE_SIZE_UNITS[exponent]}"
+      end
+    end
+
+    module Archive
+      require 'zip'
+      require 'fileutils'
+      require 'securerandom'
+
+      # Unarchive zip file
+      #
+      # source: https://github.com/soffes/lagunitas/blob/master/lib/lagunitas/ipa.rb
+      def unarchive(file, path: nil)
+        path = path ? "#{path}-" : ''
+        root_path = "#{Dir.mktmpdir}/AppInfo-#{path}#{SecureRandom.hex}"
+        Zip::File.open(file) do |zip_file|
+          if block_given?
+            yield root_path, zip_file
+          else
+            zip_file.each do |f|
+              f_path = File.join(root_path, f.name)
+              FileUtils.mkdir_p(File.dirname(f_path))
+              zip_file.extract(f, f_path) unless File.exist?(f_path)
+            end
+          end
+        end
+
+        root_path
+      end
+
+      def tempdir(file, prefix:)
+        dest_path ||= File.join(File.dirname(file), prefix)
+        dest_file = File.join(dest_path, File.basename(file))
+
+        Dir.mkdir(dest_path, 0_700) unless Dir.exist?(dest_path)
+
+        dest_file
+      end
+    end
+
+    module Defines
+      def create_class(klass_name, parent_class, namespace:)
+        klass = Class.new(parent_class) do
+          yield if block_given?
+        end
+
+        name = namespace.to_s.empty? ? klass_name : "#{namespace}::#{klass_name}"
+        if Object.const_defined?(name)
+          Object.const_get(name)
+        else
+          Object.const_get(namespace).const_set(klass_name, klass)
+        end
+      end
+
+      def define_instance_method(key, value)
+        instance_variable_set("@#{key}", value)
+        self.class.class_eval <<-RUBY, __FILE__, __LINE__ + 1
+          def #{key}
+            @#{key}
+          end
+        RUBY
+      end
+    end
+
+    module ReferenceParser
+      def reference_segments(value)
+        new_value = value.is_a?(Aapt::Pb::Reference) ? value.name : value
+        return new_value.split('/', 2) if new_value.include?('/')
+
+        [nil, new_value]
+      end
+    end
+  end
+end

data/lib/app_info/info_plist.rb

@@ -67,13 +67,13 @@ module AppInfo
     def device_type
       device_family = info.try(:[], 'UIDeviceFamily')
       if device_family == [1]
-        AppInfo::Device::IPHONE
+        Device::IPHONE
       elsif device_family == [2]
-        AppInfo::Device::IPAD
+        Device::IPAD
       elsif device_family == [1, 2]
-        AppInfo::Device::UNIVERSAL
+        Device::UNIVERSAL
       elsif !info.try(:[], 'DTSDKName').nil? || !info.try(:[], 'DTPlatformName').nil?
-        AppInfo::Device::MACOS
+        Device::MACOS
       end
     end
 
@@ -112,13 +112,13 @@ module AppInfo
     def_delegators :info, :to_h
 
     def method_missing(method_name, *args, &block)
-      info.try(:[], Util.format_key(method_name)) ||
+      info.try(:[], method_name.to_s.camelcase) ||
         info.send(method_name) ||
         super
     end
 
     def respond_to_missing?(method_name, *args)
-      info.key?(Util.format_key(method_name)) ||
+      info.key?(method_name.to_s.camelcase) ||
         info.respond_to?(method_name) ||
         super
     end

data/lib/app_info/ipa.rb

@@ -8,6 +8,8 @@ require 'cfpropertylist'
 module AppInfo
   # IPA parser
   class IPA
+    include Helper::HumanFileSize
+    include Helper::Archive
     extend Forwardable
 
     attr_reader :file
@@ -28,11 +30,11 @@ module AppInfo
     end
 
     def size(human_size: false)
-      AppInfo::Util.file_size(@file, human_size)
+      file_to_human_size(@file, human_size: human_size)
     end
 
     def os
-      AppInfo::Platform::IOS
+      Platform::IOS
     end
     alias file_type os
 
@@ -195,7 +197,7 @@ module AppInfo
     end
 
     def contents
-      @contents ||= Util.unarchive(@file, path: 'ios')
+      @contents ||= unarchive(@file, path: 'ios')
     end
 
     private
@@ -213,7 +215,7 @@ module AppInfo
 
     # Uncrush png to normal png file (iOS)
     def uncrush_png(src_file)
-      dest_file = Util.tempdir(src_file, prefix: 'uncrushed')
+      dest_file = tempdir(src_file, prefix: 'uncrushed')
       PngUncrush.decompress(src_file, dest_file)
       File.exist?(dest_file) ? dest_file : nil
     end

data/lib/app_info/macos.rb

@@ -8,6 +8,8 @@ require 'cfpropertylist'
 module AppInfo
   # MacOS App parser
   class Macos
+    include Helper::HumanFileSize
+    include Helper::Archive
     extend Forwardable
 
     attr_reader :file
@@ -24,11 +26,11 @@ module AppInfo
     end
 
     def size(human_size: false)
-      AppInfo::Util.file_size(@file, human_size)
+      file_to_human_size(@file, human_size: human_size)
     end
 
     def os
-      AppInfo::Platform::MACOS
+      Platform::MACOS
     end
     alias file_type os
 
@@ -142,7 +144,7 @@ module AppInfo
     end
 
     def contents
-      @contents ||= Util.unarchive(@file, path: 'macos')
+      @contents ||= unarchive(@file, path: 'macos')
     end
 
     private
@@ -172,7 +174,7 @@ module AppInfo
       reader = Icns::Reader.new(file)
       Icns::SIZE_TO_TYPE.each do |size, _|
         dest_filename = "#{File.basename(file, '.icns')}_#{size}x#{size}.png"
-        dest_file = Util.tempdir(File.join(File.dirname(file), dest_filename), prefix: 'converted')
+        dest_file = tempdir(File.join(File.dirname(file), dest_filename), prefix: 'converted')
         next unless icon_data = reader.image(size: size)
 
         File.write(dest_file, icon_data, encoding: Encoding::BINARY)