droid_adbs 0.3.3 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 302dcf4f5a05da77a485ba29c5aca459b358d398
-  data.tar.gz: b9468cd3132d0554e4f47a0f063484e99b349bd3
+  metadata.gz: 2fc3160c2981807d1678a39683d16661d7349bd2
+  data.tar.gz: 125713a86cc2765a0b940855425c2c032c710e33
 SHA512:
-  metadata.gz: ea7b718308ab7d9471674ee9080580b9145de7979ba72dbc1ca45d8517ad3a015ca1bd984292cd94d6441803ac11ae8b62079f46114732d179257f43238a27f6
-  data.tar.gz: 62509c42f8e529a6cb2f606c8b01008889452af5c7ef8338dce0968eb5abfa9aec83570b6fd7ddfbf350ae2e134a425a2f83d68b999dcf31e346eef0323bb1fd
+  metadata.gz: be0fad45b241f6371fd915be646f206624cfaca8f5085295a9092af7c6fccf9799c001feeb0547986e7b2a21d44ccdd521ed87ecce5a049de069dc9ee20da9ad
+  data.tar.gz: 35190176f7850dbf43899a1f447c0d7ce0844f47dfcd7166a167cc29214dbde9df32bf3a18c162f63cfae5c71ce437097a2d8e02769b935b17456948c158da8e

data/README.md

@@ -38,6 +38,14 @@ Send command over tcp:
 ::DroidAdbs.install(app_path) # install `app_path` to the device over tcp
 ```
 
+Use apkanalyzer tools.
+
+```
+@analyzer = DroidAdbs::Apkanalyzer.new "test/data/api.apk"
+@analyzer.manifest_version_name
+```
+
+
 Please read yard documents if you would like to know more.
 
 ## Development

data/lib/droid_adbs/apkanalyzer.rb

@@ -0,0 +1,201 @@
+module DroidAdbs
+  class Apkanalyzer
+    # Read https://developer.android.com/studio/command-line/apkanalyzer for more details
+
+    attr_reader :apk_path
+
+    def initialize(apk_path)
+      raise RuntimeError, "should set path to aapt, android-sdks/build-tools/xxxx" if `which apkanalyzer`.empty?
+
+      @apk_path = apk_path
+    end
+
+    # @return [String] package name
+    #
+    # @example
+    #
+    #     manifest_package_id #=> "io.appium.android.apis"
+    #
+    def manifest_package_id
+      `apkanalyzer manifest application-id #{@apk_path}`.strip
+    end
+
+    # @param [String] out_path A path to output the result
+    # @return [Integer] A number of file size
+    #
+    #
+    def manifest_print(out_path = './manifest_print.xml')
+      result = `apkanalyzer manifest print #{@apk_path}`.strip
+      File.write out_path, result
+    end
+
+    # @return [String] A number of version name by string
+    #
+    # @example
+    #
+    #     manifest_version_name #=> "1.0"
+    #
+    def manifest_version_name
+      `apkanalyzer manifest version-name #{@apk_path}`.strip
+    end
+
+    # @return [String] A number of version code by string
+    #
+    # @example
+    #
+    #     manifest_version_code #=> "1"
+    #
+    def manifest_version_code
+      `apkanalyzer manifest version-code #{@apk_path}`.strip
+    end
+
+    # @return [String] A number of min sdk by string
+    #
+    # @example
+    #
+    #     manifest_min_sdk #=> "16"
+    #
+    def manifest_min_sdk
+      `apkanalyzer manifest min-sdk #{@apk_path}`.strip
+    end
+
+    # @return [String] A number of target sdk by string
+    #
+    # @example
+    #
+    #     manifest_target_sdk #=> "22"
+    #
+    def manifest_target_sdk
+      `apkanalyzer manifest target-sdk #{@apk_path}`.strip
+    end
+
+    # @return [[String]] A list of permissions
+    #
+    # @example
+    #
+    #     manifest_permissions #=> ["android.permission.INTERNET", "android.permission.SYSTEM_ALERT_WINDOW", "android.permission.READ_EXTERNAL_STORAGE", "android.permission.WRITE_EXTERNAL_STORAGE", "android.permission.READ_PHONE_STATE"]
+    #
+    def manifest_permissions
+      `apkanalyzer manifest permissions #{@apk_path}`.strip.split("\n")
+    end
+
+    # @return [Bool] Debuggable or not
+    #
+    # @example
+    #
+    #     manifest_debuggable #=> true
+    #
+    def manifest_debuggable
+      result = `apkanalyzer manifest debuggable #{@apk_path}`.strip
+      return true if result == "true"
+      false
+    end
+
+    # Prints the application Id, version code and version name.
+    #
+    # @example
+    #
+    #     apk_summary #=> ["com.vodqareactnative", "1", "1.0"]
+    #
+    def apk_summary
+      `apkanalyzer apk summary #{@apk_path}`.strip.split("\t")
+    end
+
+    # Prints the file size of the APK.
+    # 7_414_686 (byte)
+    def apk_file_size
+      `apkanalyzer apk file-size #{@apk_path}`.strip
+    end
+
+    # Prints an estimate of the download size of the APK.
+    #
+    # @example
+    #
+    #     apk_download_size #=> 7313000
+    #
+    def apk_download_size
+      `apkanalyzer apk download-size #{@apk_path}`.strip
+    end
+
+    # Prints features used by the APK.
+    #
+    # @example
+    #
+    #     apk_features #=> "android.hardware.faketouch implied: default feature for all apps"
+    #
+    def apk_features
+      puts `apkanalyzer apk features #{@apk_path}`.strip
+    end
+
+    # Compares the sizes of two APKs.
+    def apk_compare_print(with)
+      puts `apkanalyzer apk features #{@apk_path} #{with}`.strip
+    end
+
+    # Lists all files in the zip.
+    #
+    # @example
+    #
+    #   file_list #=> "android.hardware.faketouch implied: default feature for all apps"
+    #
+    def file_list
+      `apkanalyzer files list #{@apk_path}`.strip.split("\n")
+    end
+
+    # Prints a list of dex files in the APK
+    def dex_list
+      `apkanalyzer dex list #{@apk_path}`.strip.split("\n")
+    end
+
+    # Prints number of references in dex files
+    def dex_references(options = "")
+      `apkanalyzer dex references #{options} #{@apk_path}`.strip
+    end
+
+    # Prints the class tree from DEX.
+    # P,C,M,F: indicates packages, classes methods, fields
+    # x,k,r,d: indicates removed, kept, referenced and defined nodes
+    def dex_packages(options = "")
+      `apkanalyzer dex packages #{options} #{@apk_path}`.strip
+    end
+
+    # Prints the bytecode of a class or method in smali format
+    def dex_code
+      `apkanalyzer dex code #{@apk_path}`.strip
+    end
+
+    # Prints a list of packages in resources table
+    def resources_packages
+      `apkanalyzer resources packages #{@apk_path}`.strip
+    end
+
+    # Prints a list of configurations for the specified type.
+    # @param [String] type The type is a resource type such as string.
+    # @param [String] package Include the --package option if you want to specify the resource table package name,
+    #                         otherwise the first defined package will be used.
+    #
+    def resources_configs(type, package = "")
+      `apkanalyzer resources configs --type #{type} #{package} #{@apk_path}`.strip
+    end
+
+    # Prints the value of the resource specified by config, name, and type.
+    # @param [String] config
+    # @param [String] name
+    # @param [String] type The type option is the type of the resource, such as string.
+    # @param [String] package Include the --package option if you want to specify the resource table package name,
+    #                         otherwise the first defined package will be used.
+    #
+    # @example
+    #
+    #     resources_value "default", "revision_hash", "string"
+    #
+    def resources_value(config, name, type, package = "")
+      `apkanalyzer resources value --config #{config} --name #{name} --type #{type} #{package} #{@apk_path}`.strip
+    end
+
+    # Prints the human-readable form of a binary XML file. Include the file option to specify the path to the file.
+    def resources_xml(xml_file)
+      `apkanalyzer resources xml --file #{xml_file} #{@apk_path}`.strip
+    end
+  end # class Apkanalyzer
+end # module DroidAdbs

data/lib/droid_adbs/version.rb

@@ -1,3 +1,3 @@
 module DroidAdbs
-  VERSION = "0.3.3"
+  VERSION = "0.4.0"
 end

data/lib/droid_adbs.rb

@@ -9,6 +9,7 @@ require "droid_adbs/commons/logcat"
 require "droid_adbs/commons/dumpsys"
 require "droid_adbs/commons/record"
 require "droid_adbs/aapt"
+require "droid_adbs/apkanalyzer"
 
 module DroidAdbs
   class << self

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: droid_adbs
 version: !ruby/object:Gem::Version
-  version: 0.3.3
+  version: 0.4.0
 platform: ruby
 authors:
 - Kazuaki MATSUO
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-12-07 00:00:00.000000000 Z
+date: 2018-05-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -70,6 +70,7 @@ files:
 - droid_adbs.gemspec
 - lib/droid_adbs.rb
 - lib/droid_adbs/aapt.rb
+- lib/droid_adbs/apkanalyzer.rb
 - lib/droid_adbs/commons/backup.rb
 - lib/droid_adbs/commons/devices.rb
 - lib/droid_adbs/commons/doze.rb