android_parser 2.5.1 → 2.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8360af54a4093e8cc95844b8b7419e3190aed92f5aa6c832f0fd4f7e8ccd2f53
-  data.tar.gz: 1b8a9172fdf2b4f18c43cb0a342aa5244f7ad109cbfc8b8995d74d6de9fc34a9
+  metadata.gz: 5a455cf668b1e1fbae27b208a872c304ac7ff60987034c529aa93c676b3e4348
+  data.tar.gz: 5089aec3a63dec1766ae3c981442c2a6fa9500f1351d0e989552e84047309443
 SHA512:
-  metadata.gz: 393956811a1cfcb6bd043cdc8c6494a1760a0558d6d12ce157ee9e08b67035499f702e15cf8d6baa7971572eb616c0de28ebc92003a4e9a32c18541eb82b7f7b
-  data.tar.gz: a7998f5d5e71b889c083f6b1d73f4d277bd7aecd6c412a5d4b14dc10bccf1104472dffde03c2a2280071f88c846906f15c80991d73689f2dd957a46270ac3fbf
+  metadata.gz: b4e6104d2a29750902a79871b5a3e2750ea3ea3a8fdcde709870950ca93ddeaa2299f481c393be9556e21378a88c843afe8b9123b338c7a7e7c204a2800c6b99
+  data.tar.gz: 9474805fe13212f5193817cf0bc22b33163211232ec01cf4ad60b65eb4713992d701f3883f87241eb2d8b532d00397d6c641c167b19db4b8d71fc314bf87d352

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/')
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

data/Gemfile

@@ -3,8 +3,7 @@ source 'http://rubygems.org'
 # Specify your gem's dependencies in android_parser.gemspec
 gemspec
 
-# group :development do
-#   gem 'awesome_print'
-#   gem 'debase'
-#   gem 'ruby-debug-ide'
-# end
+group :development do
+  gem 'awesome_print'
+  gem 'debug'
+end

data/README.md

@@ -55,7 +55,7 @@ icons.each do |name, data|
 end
 ```
 
-#### Extract signature and certificate information from Apk (since v0.7.0)
+#### Extract v1 signature and certificate information from Apk (since v0.7.0)
 
 ```ruby
 apk = Android::Apk.new('sample.apk')

data/android_parser.gemspec

@@ -5,7 +5,7 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 
 Gem::Specification.new do |spec|
   spec.name          = 'android_parser'
-  spec.version       = '2.5.1'
+  spec.version       = '2.6.0'
   spec.authors       = ['SecureBrain', 'icyleaf']
   spec.email         = ['info@securebrain.co.jp', 'icyleaf.cn@gmail.com']
   spec.platform      = Gem::Platform::RUBY

data/lib/android/apk.rb

@@ -189,7 +189,7 @@ module Android
     # @return [nil] when label is not found
     # @deprecated move to {Android::Manifest#label}
     # @since 0.6.0
-    def label(lang=nil)
+    def label(lang = nil)
       @manifest.label
     end
 
@@ -200,25 +200,63 @@ module Android
       @layouts ||= Layout.collect_layouts(self) # lazy parse
     end
 
-    # apk's signature information
+    # apk's v1 signature information
     # @return [Hash{ String => OpenSSL::PKCS7 } ] key: sign file path, value: signature
     # @since 0.7.0
     def signs
-      signs = {}
-      self.each_file do |path, data|
-        # find META-INF/xxx.{RSA|DSA}
-        next unless path =~ /^META-INF\// && data.unpack("CC") == [0x30, 0x82]
-        signs[path] = OpenSSL::PKCS7.new(data)
-      end
-      signs
+      @signs ||= lambda {
+        signs = {}
+        self.each_file do |path, data|
+          # find META-INF/xxx.{RSA|DSA|EC}
+          next unless path =~ /^META-INF\// && data.unpack("CC") == [0x30, 0x82]
+
+          signs[path] = OpenSSL::PKCS7.new(data)
+        end
+        signs
+      }.call
     end
 
-    # certificate info which is used for signing
+    # v1 certificate info which is used for signing
     # @return [Hash{String => OpenSSL::X509::Certificate }] key: sign file path, value: first certficate in the sign file
     # @since 0.7.0
     def certificates
-      return Hash[self.signs.map{|path, sign| [path, sign.certificates.first] }]
+      @certificates ||= Hash[self.signs.map{|path, sign| [path, sign.certificates.first] }]
+    end
+
+    # detect if use kotlin language (may be third-party sdk or not)
+    # @return [Boolean]
+    # @since 2.6.0
+    def kotlin?
+      @kotlin ||= kotlin_file? || kotlin_classes?
     end
+
+    private
+
+    def kotlin_file?
+      KOTLIN_FILES.any? do |file|
+        begin
+          entry(file)
+        rescue
+          next
+        end
+      end
+    end
+
+    def kotlin_classes?
+      @dex.classes.any? do |class_info|
+        class_info.type.start_with?('kotlin.') ||
+        class_info.type.start_with?('kotlinx.')
+      end
+    end
+
+    KOTLIN_FILES = [
+      'kotlin-tooling-metadata.json',
+      'kotlin/kotlin.kotlin_builtins',
+      'META-INF/kotlinx_coroutines_android.version',
+      'META-INF/kotlinx_coroutines_core.version',
+      'META-INF/services/kotlinx.coroutines.CoroutineExceptionHandler',
+      'META-INF/services/kotlinx.coroutines.internal.MainDispatcherFactory'
+    ].freeze
   end
 end
 

data/lib/android/dex/info.rb

@@ -29,16 +29,32 @@ module Android
       # @return [DexObject::ClassDefItem]
       attr_reader :class_def
 
+      # return full namespace of class
+      #
+      # sample value like `Landroidx/activity/Cancellable;`
+      #
+      # @return [String] class name
       def name
-        @dex.type_resolve(@class_def[:class_idx])
+        @name ||= @dex.type_resolve(@class_def[:class_idx])
       end
+
       def super_class
-        if @class_def[:superclass_idx] != NO_INDEX
-          @super_class = @dex.type_resolve(@class_def[:superclass_idx])
-        else
-          nil
-        end
+        @super_class ||= if @class_def[:superclass_idx] != NO_INDEX
+            @dex.type_resolve(@class_def[:superclass_idx])
+          else
+            nil
+          end
+      end
+
+      # Convert name to human readable string
+      #
+      # From `Landroidx/activity/Cancellable;` to `androidx.activity.Cancellable`
+      #
+      # @return [String] human readable name
+      def type
+        @type ||= name.gsub('/', '.')[1..-2]
       end
+
       # @param [Dex::ClassDefItem] class_def
       # @param [Dex] dex dex class instance
       def initialize(class_def, dex)
@@ -62,6 +78,7 @@ module Android
       end
 
       private
+
       def cls2info(arr, cls, idx_key)
         idx = 0
         ret = []

data/lib/android/manifest.rb

@@ -10,7 +10,7 @@ module Android
     # <activity>, <service>, <receiver> or <provider> element in <application> element of the manifest file.
     class Component
       # component types
-      TYPES = ['activity', 'activity-alias', 'service', 'receiver', 'provider', 'application']
+      TYPES = ['activity', 'activity-alias', 'service', 'receiver', 'provider', 'application', 'queries']
 
       # the element is valid Component element or not
       # @param [REXML::Element] elem xml element
@@ -322,6 +322,99 @@ module Android
       end
     end
 
+    # <intent>, <service>, <receiver> or <provider> element in <application> element of the manifest file.
+    class QueriesComponent
+      # component types
+      TYPES = ['package', 'intent', 'provider']
+
+      # @return [String] type string in TYPES
+      attr_reader :type
+      # @return [Manifest::Queries::Package]
+      attr_reader :packages
+      # @return [Array<Manifest::Queries::Intent>]
+      attr_reader :intents
+      # @return [Array<Manifest::Queries::Provider>]
+      attr_reader :providers
+      # @return [REXML::Element]
+      attr_reader :elem
+
+      # @param [REXML::Element] elem target element
+      # @raise [ArgumentError] when elem is invalid.
+      def initialize(elem)
+        raise ArgumentError unless Component.valid?(elem)
+
+        @elem = elem
+        @type = elem.name
+        @packages = parse_packages
+        @intents = parse_intents
+        @providers = parse_providers
+      end
+
+      private
+
+      def parse_packages
+        packages = []
+        return packages if @elem.elements['package'].nil?
+
+        @elem.each_element('package') do |package|
+          packages << Android::Manifest::Queries::Package.new(package)
+        end
+
+        packages
+      end
+
+      def parse_intents
+        intents = []
+        return intents if @elem.elements['intent'].nil?
+
+        @elem.each_element('intent') do |intent|
+          next if intent&.elements&.empty?
+          next unless Android::Manifest::Queries::Intent.valid?(intent)
+
+          intent = Android::Manifest::Queries::Intent.new(intent)
+          intents << intent unless intent.empty?
+        end
+
+        intents
+      end
+
+      def parse_providers
+        providers = []
+        return providers if @elem.elements['provider'].nil?
+
+        @elem.each_element('provider') do |provider|
+          providers << Android::Manifest::Queries::Provider.new(provider)
+        end
+
+        providers
+      end
+    end
+
+    class Queries < QueriesComponent
+      class Intent < Android::Manifest::IntentFilter; end
+      class Provider < Android::Manifest::Provider
+        def authorities
+          @authorities ||= @elem.attributes['authorities']
+        end
+      end
+
+      class Package
+        # @return [String] action name of queries
+        attr_reader :name
+        # @return [String] action type of intent-filter
+        attr_reader :type
+
+        def initialize(elem)
+          @type = 'package'
+          @name = elem.attributes['name']
+        end
+      end
+
+      def self.valid?(elem)
+        elem&.name == 'queries'
+      end
+    end
+
     #################################
     # Manifest class definitions
     #################################
@@ -370,6 +463,13 @@ module Android
       components
     end
 
+    # Returns the manifest's queries element or nil, if there isn't any.
+    # @return [Android::Manifest::Queries] the manifest's application element
+    def queries
+      element = @doc.elements['/manifest/queries']
+      Queries.new(element) if Queries.valid?(element)
+    end
+
     # @return [Array<Android::Manifest::Activity&ActivityAlias>] all activities in the apk
     # @note return empty array when the manifest include no activities
     def activities

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: android_parser
 version: !ruby/object:Gem::Version
-  version: 2.5.1
+  version: 2.6.0
 platform: ruby
 authors:
 - SecureBrain
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-03-09 00:00:00.000000000 Z
+date: 2023-03-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rubyzip
@@ -139,6 +139,7 @@ extra_rdoc_files: []
 files:
 - ".github/dependabot.yml"
 - ".github/workflows/ci.yml"
+- ".github/workflows/create_release.yml"
 - ".gitignore"
 - ".rspec"
 - CHANGELOG.md