[Android Apps and Games] mikrosmile:
WIP

myHUB Configuration Guide. How to set-up myHUB​

For myHUB you don't need any specific Server settings or even Hosting server at all. You can use any file-hosting as DropBox, Google Drive, DevHost etc. But the only problem is you need to find direct URL to the files (xml file, apk file etc) see below how. ​

By using this Guide and setting up myHUB in your ROM, you are agree with above terms​

STEP 1. CONFIGURATION FILE, “MYHUB.TXT”.

All you need to get working the app is one txt file in your System folder. Create or download example file “myHUB.txt”

Fields in the file:

main=http://mikrosense.com/sensehub/sections.xml
rom_upd=http://mikrosense.com/sensehub/update.xml
rom_name=DarkSense
rom_v=1.3.5
rom_dev=Jonny & mikrosmile

main – the link to the xml file on server which represents the Main menu in the app (See step 2);

rom_upd – the link to the xml file on server, which provides OTA update of your ROM (See step 4);

rom_name – Enter your ROM name;

rom_v – Enter the current version of your ROM;

rom_dev – Enter your name

You can setup either full working server or any File hosting (DropBox, Google Drive).

In case of using DropBox or Google Drive, you need to find the full link to the file first and insert it. For example, you upload a file to DropBox, start downloading it and in Downloads page (e.g. Chrome Browser), you will see full, direct link to the file. That one you need to use in configuration file.​

STEP 2. CONFIGURATION FILE ON SERVER (MAIN MENU IN APP)

The file from step 1 under “main”;

You can create your own or download example “sections.xml”

The fields in the file:

<?xml version="1.0" encoding="UTF-8"?>
<body>
<item headline = "News">
<text>Latest news about ROM Development</text>
<section>news</section>
<image-url>http://mikrosense.com/sensehub/ic_news3.png</image-url>
<file_ext>apk</file_ext>
<url>http://mikrosense.com/sensehub/news.xml</url>
<details1></details1>
<details2></details2>
<date></date>
</item>

<item headline = "Skins">
<section>mods</section>
<dl_path>Skins</dl_path>
<text>Download amazing Skins for your Device</text>
<image-url>http://mikrosense.com/sensehub/ic_skins.png</image-url>
<file_ext>apk</file_ext>
<url>http://mikrosense.com/sensehub/skins.xml</url>
<details1></details1>
<details2></details2>
<date></date>
</item>

<item headline = "Kernels">
<section>kernels</section>
<dl_path>Kernels</dl_path>
<text>Simply download and install latest Kernels just from the app</text>
<image-url>http://mikrosense.com/sensehub/ic_kernels.png</image-url>
<file_ext>apk</file_ext>
<url>http://mikrosense.com/sensehub/kernels.xml</url>
<details1></details1>
<details2></details2>
<date></date>
</item>

</body>

The sections starts with <item> and ends with </item>. Within this tags you will identify everything you need to get working.

<item headline = “News”> - Represents name of the Section. You can name it as you want

<section></section> - this is represents Type of the section. This is compulsory field to identify how the app will know what content you want to provide. For news, it will use special made Layout to present them in a special text only way, the same as kernels. For other things apart from News and Kernels use tag mods, which can be anything you want, Skins, Icons, System MODs, etc.

<dl_path></dl_path> - Now you can set your own Download path. Note that you can use only English letters as Recovery does not recognize another languages

<image-url></image-url> - this is link to Section icon in the Main menu

<file_ext></file_ext> - Enter the file extension you want to provide.

<url></url> - This is the link to Individual Sections which you need to configure as well (See step 3);

Available section types:

news

mods

kernels

Available types:

apk

zip

STEP 3. CONFIGURATION FILE FOR NEWS, MODS, KERNELS, ETC

Here we will create Individual sections files for all Sections in your Main menu.

Let’s start from News type; You can create or download example file “news.xml”

<?xml version="1.0" encoding="UTF-8"?>
<body>
<item headline = "Welcome!">
<text></text>
<news_link>http://xdaforums.com/showthread.php?t=2230067</news_link>
<date>03.06.2013</date>
</item>

<item headline = "Another News">
<text>Your text for another news</text>
<news_link></news_link>
<date>06.03.2013</date>
</item>

</body>

<item headline = “Welcome!”> - This is Headline of your News

<text></text> - Here you can enter any text on any language you want to. It also support multi-line texting. Just type as you are comfortable.

<news_link></news_link> - If your news does not contain enough information or you want the users to open a page in web, you can enter it, and the app itself will open it in the myHUB Web application.

<date></date> - This is the date of posting News

MODs type

<?xml version="1.0" encoding="UTF-8"?>
<body>
<item headline = "Blue+Orange Skin">
<text>Made by 12Reza12</text>
<image-url>http://mikrosense.com/sensehub/skin.png</image-url>
<file_ext>apk</file_ext>
<url>http://mikrosense.com/sensehub/Serene.apk</url>
<md5>d209ecdb2bacc7ac4aef806568236a67</md5>
</item>

<item headline = "Serene Skin">
<text>HTC Skin from HTC Hub</text>
<image-url></image-url>
<file_ext>apk</file_ext>
<md5></md5>
</item>

</body>

<item headline = “Name”> - This represents Name of the File.

<text></text> - This is another text field, you can enter anything you want. Size, Version, etc;

<image-url><image-url> - The image preview for the Mod, Skin, Icon, etc;

<file_ext></file_ext> - File extension you want to provide.

<md5></md5> - MD5 file sum. Needs to compare MD5 after finish of downloading file

Available types:

apk

zip

Kernels type;

<?xml version="1.0" encoding="UTF-8"?>
<body>
<item headline = "Sultan Kernel">
<file_ext>zip</file_ext>
<url>http://mikrosense.com/store/kernels/kernel.zip</url>
<details1></details1>
<date></date>
<md5>8e92b519b5211d5769e3abe0719cf686</md5>
</item>
</body>

<item headline = “Name”> - Kernel name

<file_ext></file_ext> - File extension you want to provide

<url></url> - The direct link to the file on your Server or any File storage

<details1></details1> - Details of your Kernel. Supports multi-line

<date></date> - Date of upload the Item

<md5></md5> - MD5 file sum

STEP 4. CONFIGURATION FILE FOR OTA

You can create your own or download example file – “update.xml”

Field in the file:

<?xml version="1.0" encoding="UTF-8"?>
<body>
<item headline = "1.3.6">
<text>Here will be your Changelog of the ROM</text>
<url></url>
<md5></md5>
</item>
</body>

<item headline = “X.X.X”> - the version of your New ROM, this version should be higher than the one in myHUB.txt file. Therefore, it will compare these two versions. All the time you update your rom, do not forget to update myHUB.txt as well.

<text></text> - Here you can enter your changelog;

<url></url> - The direct link to the file on your Server or File storage;

<md5></md5> - MD5 file sum