android_parser 2.4.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a338a6e092fc1dc50e3c1688f165109dbb900397e51b968b0397877aa4f6a030
+  data.tar.gz: 5fbbb6f2630a3a4d2a7b090106c53dd45ac9b8ec6b4be9cb37477d1c5615c594
+SHA512:
+  metadata.gz: 7c270a031fc08369c7afa11e274da90c3aa732b86cade0b10066a227de49bafb30b0dd8b14ce7b77a3a347fda85bfefcf5796c55f8b2a5c645309d625030f01c
+  data.tar.gz: e850a3d98e71801a57686f8b890d45fa1d65d3459805b6855f9451990a960ba6f608ed147c88ea9ded54fb40ab8c49b4d89d19e014172aa24b8a36ba329dc7d9

data/.gitignore

@@ -0,0 +1,54 @@
+# rcov generated
+coverage
+
+# rdoc generated
+rdoc
+
+# yard generated
+doc
+.yardoc
+
+# bundler
+.bundle
+
+# rvm
+.ruby-version
+
+# jeweler generated
+#pkg # upload gem file to server
+
+# Have editor/IDE/OS specific files you need to ignore? Consider using a global gitignore: 
+#
+# * Create a file at ~/.gitignore
+# * Include files you want ignored
+# * Run: git config --global core.excludesfile ~/.gitignore
+#
+# After doing this, these files will be ignored in all your git projects,
+# saving you from having to 'pollute' every project you touch with them
+#
+# Not sure what to needs to be ignored for particular editors/OSes? Here's some ideas to get you started. (Remember, remove the leading # of the line)
+#
+# For MacOS:
+#
+.DS_Store
+.idea
+
+# For TextMate
+#*.tmproj
+#tmtags
+
+# For emacs:
+#*~
+#\#*
+#.\#*
+
+# For vim:
+*.swp
+
+# For redcar:
+#.redcar
+
+# For rubinius:
+#*.rbc
+
+pkg/

data/.travis.yml

@@ -0,0 +1,5 @@
+language: ruby
+rvm:
+  - 2.2.2
+  - 2.3.3
+  - 2.4.1

data/CHANGELOG.md

@@ -0,0 +1,45 @@
+# ChangeLog
+## 0.7.0
+* implement Apk#signs, Apk#certificates and Manifest#version_name (#14, #15)
+* bugfix
+
+## 0.6.0
+* implement Android::Apk#layouts(#10), Android::Apk#icon(#11), Android::Apk#label(#12),
+* fix bug (#13)
+
+## 0.5.1
+* [#8] add Android::Manifest#label
+* [#7] fix wrong boolean value in manifest parser
+* [#6] add accessor Android::Manifest#doc
+
+## 0.5.0
+* [issue #1] implement Android::Resource#find, #res_readable_id, #res_hex_id methods
+
+## 0.4.2
+* fix bugs(#2, #3)
+* divide change log from readme
+
+## 0.4.1
+* fix typo
+* add document
+
+## 0.4.0
+* add resource parser
+* enhance dex parser
+
+## 0.3.0
+* add and change name space
+* add Android::Utils module and some util methods
+* add Apk#entry, Apk#each_entry, and Apk#time methods,
+
+## 0.2.0
+* update documents
+* add Apk::Dex#each_strings, Apk::Dex#each_class_names
+
+## 0.1.2
+* fix bug(improve android binary xml parser)
+
+## 0.1.1
+* fix bug(failed to initialize Apk::Manifest::Meta class)
+* replace iconv to String#encode(for ruby1.9)
+

data/Gemfile

@@ -0,0 +1,18 @@
+source "http://rubygems.org"
+# Add dependencies required to use your gem here.
+# Example:
+#   gem "activesupport", ">= 2.3.5"
+gem "rubyzip", ">=1.0.0"
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+group :development do
+  gem "rspec-its", ">= 1.2.0"
+  gem "rspec-collection_matchers", ">= 1.1.0"
+  gem "rspec-mocks", ">= 3.6.0"
+  gem "bundler", ">= 1.1.5"
+  gem "jeweler"
+  gem "yard", require: false
+  gem "redcarpet"
+  gem "simplecov", require: false
+end

data/Gemfile.lock

@@ -0,0 +1,92 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    addressable (2.4.0)
+    builder (3.2.3)
+    descendants_tracker (0.0.4)
+      thread_safe (~> 0.3, >= 0.3.1)
+    diff-lcs (1.3)
+    docile (1.1.5)
+    faraday (0.9.2)
+      multipart-post (>= 1.2, < 3)
+    git (1.3.0)
+    github_api (0.16.0)
+      addressable (~> 2.4.0)
+      descendants_tracker (~> 0.0.4)
+      faraday (~> 0.8, < 0.10)
+      hashie (>= 3.4)
+      mime-types (>= 1.16, < 3.0)
+      oauth2 (~> 1.0)
+    hashie (3.5.7)
+    highline (1.7.10)
+    jeweler (2.3.9)
+      builder
+      bundler
+      git (>= 1.2.5)
+      github_api (~> 0.16.0)
+      highline (>= 1.6.15)
+      nokogiri (>= 1.5.10)
+      psych
+      rake
+      rdoc
+      semver2
+    json (2.1.0)
+    jwt (1.5.6)
+    mime-types (2.99.3)
+    mini_portile2 (2.3.0)
+    multi_json (1.13.1)
+    multi_xml (0.6.0)
+    multipart-post (2.0.0)
+    nokogiri (1.8.2)
+      mini_portile2 (~> 2.3.0)
+    oauth2 (1.4.0)
+      faraday (>= 0.8, < 0.13)
+      jwt (~> 1.0)
+      multi_json (~> 1.3)
+      multi_xml (~> 0.5)
+      rack (>= 1.2, < 3)
+    psych (3.0.2)
+    rack (2.0.4)
+    rake (12.3.0)
+    rdoc (6.0.1)
+    redcarpet (3.4.0)
+    rspec-collection_matchers (1.1.3)
+      rspec-expectations (>= 2.99.0.beta1)
+    rspec-core (3.6.0)
+      rspec-support (~> 3.6.0)
+    rspec-expectations (3.6.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.6.0)
+    rspec-its (1.2.0)
+      rspec-core (>= 3.0.0)
+      rspec-expectations (>= 3.0.0)
+    rspec-mocks (3.6.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.6.0)
+    rspec-support (3.6.0)
+    rubyzip (1.2.1)
+    semver2 (3.4.2)
+    simplecov (0.15.1)
+      docile (~> 1.1.0)
+      json (>= 1.8, < 3)
+      simplecov-html (~> 0.10.0)
+    simplecov-html (0.10.2)
+    thread_safe (0.3.6)
+    yard (0.9.12)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (>= 1.1.5)
+  jeweler
+  redcarpet
+  rspec-collection_matchers (>= 1.1.0)
+  rspec-its (>= 1.2.0)
+  rspec-mocks (>= 3.6.0)
+  rubyzip (>= 1.0.0)
+  simplecov
+  yard
+
+BUNDLED WITH
+   1.15.4

data/LICENSE.txt

@@ -0,0 +1,22 @@
+(The MIT License)
+
+Copyright (c) 2012 Securebrain
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,158 @@
+# ruby_apk
+Android Apk static analysis library for Ruby.
+
+[![Gem Version](https://badge.fury.io/rb/ruby_apk.png)](http://badge.fury.io/rb/ruby_apk)
+[![Build Status](https://travis-ci.org/playtestcloud/ruby_apk.svg?branch=master)](https://travis-ci.org/playtestcloud/ruby_apk)
+[![Dependency Status](https://gemnasium.com/badges/github.com/playtestcloud/ruby_apk.png)](https://gemnasium.com/github.com/playtestcloud/ruby_apk)
+
+## Requirements
+- ruby(>=2.2.2)
+
+## Install
+    $ gem install ruby_apk
+
+## Usage
+### Initialize
+```ruby
+  require 'ruby_apk'
+  apk = Android::Apk.new('sample.apk') # set apk file path
+```
+
+### Apk
+#### Listing files in Apk
+```ruby
+# listing files in apk
+apk = Android::Apk.new('sample.apk')
+apk.each_file do |name, data|
+  puts "#{name}: #{data.size}bytes" # puts file name and data size
+end
+```
+
+#### Find files in Apk
+```ruby
+  apk = Android::Apk.new('sample.apk')
+  elf_files = apk.find{|name, data| data[0..3] == [0x7f, 0x45, 0x4c, 0x46] } # ELF magic number
+```
+
+#### Extract icon data in Apk (since 0.6.0)
+```ruby
+  apk = Android::Apk.new('sample.apk')
+  icons = apk.icon # { "res/drawable-hdpi/ic_launcher.png" => "\x89PNG\x0D\x0A...", ... }
+  icons.each do |name, data|
+    File.open(File.basename(name), 'wb') {|f| f.write data } # save to file.
+  end
+```
+
+#### Extract signature and certificate information from Apk (since v0.7.0)
+```ruby
+  apk = Android::Apk.new('sample.apk')
+  signs = apk.signs # retrun Hash(key: signature file path, value: OpenSSL::PKCS7)
+  signs.each do |path, sign|
+    puts path # => "MATA-INF/CERT.RSA" or ...
+    puts sign # => "-----BEGIN PKCS7-----\n..." PKCS7 object
+  end
+
+  certs = apk.certificates # retrun Hash(key: signature file path, value: OpenSSL::X509::Certificate)
+  certs.each do |path, cert|
+    puts path # => "MATA-INF/CERT.RSA" or ...
+    puts cert # => "-----BEGIN CERTIFICATE-----\n..." # X509::Certificate object
+  end
+```
+Note: Most apks have only one signature and cerficate.
+
+### Manifest
+#### Get readable xml
+```ruby
+  apk = Android::Apk.new('sample.apk')
+  manifest = apk.manifest
+  puts manifest.to_xml
+```
+
+#### Listing components and permissions
+```ruby
+  apk = Android::Apk.new('sample.apk')
+  manifest = apk.manifest
+  # listing components
+  manifest.components.each do |c| # 'c' is Android::Manifest::Component object
+    puts "#{c.type}: #{c.name}" 
+    c.intent_filters.each do |filter|
+      puts "\t#{filter.type}"
+    end
+  end
+
+  # listing use-permission tag
+  manifest.use_permissions.each do |permission|
+    puts permission
+  end
+```
+
+#### Extract application label string
+```ruby
+  apk = Android::Apk.new('sample.apk')
+  puts apk.manifest.label
+```
+
+### Resource
+#### Extract resource strings from apk
+```ruby
+  apk = Android::Apk.new('sample.apk')
+  rsc = apk.resource
+  rsc.strings.each do |str|
+    puts str
+  end
+```
+
+#### Parse resource file directly
+```ruby
+  rsc_data = File.open('resources.arsc', 'rb').read{|f| f.read }
+  rsc = Android::Resource.new(rsc_data)
+```
+
+### Resolve resource id
+This feature supports only srting resources for now.
+
+```ruby
+  apk = Android::Apk.new('sample.apk')
+  rsc = apk.resource
+  
+  # assigns readable resource id
+  puts rsc.find('@string/app_name') # => 'application name'
+
+  # assigns hex resource id
+  puts rsc.find('@0x7f040000') # => 'application name'
+
+  # you can set lang attribute.
+  puts rsc.find('@0x7f040000', :lang => 'ja')
+```
+
+
+### Dex
+#### Extract dex information
+```ruby
+  apk = Android::Apk.new('sample.apk')
+  dex = apk.dex
+  # listing string table in dex
+  dex.strings.each do |str|
+    puts str
+  end
+
+  # listing all class names
+  dex.classes.each do |cls| # cls is Android::Dex::ClassInfo
+    puts "class: #{cls.name}"
+    cls.virtual_methods.each do |m| # Android::Dex::MethodInfo
+      puts "\t#{m.definition}" # puts method definition
+    end
+  end
+```
+
+#### Parse dex file directly
+```ruby
+  dex_data = File.open('classes.dex','rb').read{|f| f.read }
+  dex = Android::Dex.new(dex_data)
+```
+
+
+## Copyright
+
+Copyright (c) 2012 SecureBrain. See LICENSE.txt for further details.
+

data/Rakefile

@@ -0,0 +1,44 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+require 'bundler/gem_tasks'
+
+# require 'jeweler'
+# Jeweler::Tasks.new do |gem|
+#   # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+#   gem.name = "android_parser"
+#   gem.homepage = "https://github.com/icyleaf/ruby_apk"
+#   gem.license = "MIT"
+#   gem.summary = %Q{static analysis tool for android apk}
+#   gem.description = %Q{static analysis tool for android apk}
+#   gem.email = "info@securebrain.co.jp"
+#   gem.authors = ["SecureBrain"]
+#   # dependencies defined in Gemfile
+# end
+# Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+
+task :default => :spec
+
+# require 'yard'
+# require 'yard/rake/yardoc_task'
+# YARD::Rake::YardocTask.new do |t|
+#   t.files = ['lib/**/*.rb']
+#   t.options = []
+#   t.options << '--debug' << '--verbose' if $trace
+# end