From: Hans-Emil Skogh <hansemil@gmail.com>
Date: Sat, 14 Jan 2012 11:22:19 +0000 (+0100)
Subject: Displaying of human readable Android permissions for each package in the repo.
X-Git-Tag: 0.1~1063^2~10
X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=commitdiff_plain;h=9355640475f26bc885c2079e8138dbb6509119f1;p=fdroidserver.git

Displaying of human readable Android permissions for each package in the repo.

Conflicts:
	wp-fdroid/wp-fdroid.php
---

9355640475f26bc885c2079e8138dbb6509119f1
diff --cc wp-fdroid/android-permissions.php
index 00000000,6b8c2805..e19b897a
mode 000000,100644..100644
--- a/wp-fdroid/android-permissions.php
+++ b/wp-fdroid/android-permissions.php
@@@ -1,0 -1,114 +1,114 @@@
+ <?php
+ // Class that provides PHP-friendly android permissions information from the raw Andoid source XML files that describes the permissions.
+ class AndroidPermissions
+ {
+ 
+ 	// Path to the AndroidManifest.xml-file from the Android source. Get it from https://raw.github.com/android/platform_frameworks_base/master/core/res/AndroidManifest.xml for example.
+ 	private $android_manifest_file_path;
+ 	// Path to the strings.xml-file from the Android source. Get it from https://raw.github.com/android/platform_frameworks_base/master/core/res/res/values/strings.xml for example.
+ 	private $android_strings_file_path;
+ 	// Path to the file where the resulting permissions data will be cached. NOTE: Must be writable by PHP!
+ 	private $cache_file_path;
+ 
+ 	public function __construct($android_manifest_file_path_in = 'AndroidManifest.xml', $android_strings_file_path_in = 'strings.xml', $cache_file_path_in = 'android-permissions.cache') {
+ 		$this->android_manifest_file_path = $android_manifest_file_path_in;
+ 		$this->android_strings_file_path = $android_strings_file_path_in;
+ 		$this->cache_file_path = $cache_file_path_in;
+ 	}
+ 	
+ 	// Returns an associative array with android permissions and data about them
+ 	function get_permissions_array() {
+ 
+ 		// Check status of cache
+ 		$android_manifest_file_stat = stat($this->android_manifest_file_path);
+ 		$android_manifest_file_mtime = $android_manifest_file_stat['mtime'];
+ 		$android_strings_file_stat = stat($this->android_strings_file_path);
+ 		$android_strings_file_mtime = $android_strings_file_stat['mtime'];
+ 		$cache_file_mtime = 0;
+ 		if(file_exists($this->cache_file_path)) {
+ 			$cache_file_stat = stat($this->cache_file_path);
+ 			$cache_file_mtime = $cache_file_stat['mtime'];
+ 		}
+ 
+ 		// If the cache is fresh, use it instead
+ 		if($android_manifest_file_mtime < $cache_file_mtime && $android_strings_file_mtime < $cache_file_mtime ) {
+ 			$cache_file_handle = fopen($this->cache_file_path, 'r');
+ 			$cache_file_content = fread($cache_file_handle, filesize($this->cache_file_path));
+ 			fclose($cache_file_handle);
+ 
+ 			$permissions = unserialize($cache_file_content);
+ 
+ 			return $permissions;
+ 		}
+ 
+ 		// We are updating the cache, touch the file (note: race condition possible between stating the cache file above and this line...)
+ 		touch($this->cache_file_path);
+ 
+ 		// Get permission raw data from XML
+ 		$manifestDoc = new DOMDocument;
+ 		$manifestDoc->load($this->android_manifest_file_path);
+ 		$manifestXpath = new DOMXPath($manifestDoc);
+ 
+ 		$stringsDoc = new DOMDocument;
+ 		$stringsDoc->load($this->android_strings_file_path);
+ 		$stringsXpath = new DOMXPath($stringsDoc);
+ 
+ 		$comment = '';
+ 		foreach ($manifestXpath->query('node()') as $node) {
+ 			// Save permissions and permission groups from tags
+ 			if($node->nodeName == 'permission-group' || $node->nodeName == 'permission') {
+ 				$name = $node->attributes->getNamedItem('name')->value;
+ 				$name = substr(strrchr($name,'.'), 1);
+ 
+ 				// Lookup the human readable title
+ 				$labelObject = $node->attributes->getNamedItem('label');
+ 				$labelString = $name;
+ 				if( $labelObject !== NULL ) {
+ 					$labelName = substr(strrchr($labelObject->value,'/'),1);
+ 					$labelStringObject = $stringsXpath->query('//string[@name="'.$labelName.'"]');
+ 					$labelString = ucfirst($labelStringObject->item(0)->nodeValue);
+ 				}
+ 
+ 				// Lookup the human readable description
+ 				$descriptionObject = $node->attributes->getNamedItem('description');
+ 				$descriptionString = '(Description missing)';
+ 				if($descriptionObject !== NULL) {
+ 					$descriptionName = substr(strrchr($descriptionObject->value,'/'),1);
+ 					$descriptionStringObject = $stringsXpath->query('//string[@name="'.$descriptionName.'"]');
+ 					$descriptionString = ucfirst($descriptionStringObject->item(0)->nodeValue);
+ 				}
+ 
+ 				$permissions[$node->nodeName][$name]['label'] = stripslashes($labelString);
+ 				$permissions[$node->nodeName][$name]['description'] = stripslashes($descriptionString);
+ 				$permissions[$node->nodeName][$name]['comment'] = stripslashes(str_replace(array("\r\n", "\r", "\n", "\t", '  '), '', $comment));
+ 
+ 				if($node->nodeName == 'permission') {
+ 					$permissionGroupObject = $node->attributes->getNamedItem('permissionGroup');
+ 					$permissionGroup = 'none';
+ 					if($permissionGroupObject !== NULL) {
+ 						$permissionGroup = substr(strrchr($permissionGroupObject->value,'.'), 1);
+ 					}
+ 
+ 					$permissions[$node->nodeName][$name]['permissionGroup'] = $permissionGroup;
+ 					$permissions[$node->nodeName][$name]['protectionLevel'] = $node->attributes->getNamedItem('protectionLevel')->value;
+ 				}
+ 			}
+ 
+ 			// Cache descriptions from comments preceding the tags
+ 			if($node->nodeName == '#comment') {
+ 				$comment .= $node->textContent;
+ 			}
+ 			elseif($node->nodeName != '#text') {
+ 				$comment = '';
+ 			}
+ 		}
+ 
+ 		// Update cache with serialized permissions
 -		$cache_file_handle = fopen($cache_file_path, 'w');
++		$cache_file_handle = fopen($this->cache_file_path, 'w');
+ 		fwrite($cache_file_handle, serialize($permissions));
+ 		fclose($cache_file_handle);
+ 
+ 		return $permissions;
+ 	}
+ }
+ ?>