Appendix B - View Javadoc and/or sources of the Android API
If you are OK with giving ~600MB of hard drive to have an integrated local documentation & sources for the Android API (all the code made by Google, not the one made by Andor's Trail dev team), follow these instructions:
Open the "SDK Manager" ("<ADT Root>/SDK Manager.exe"), and under the API version you are using (API 18 these days), select the "Documentation for the Android SDK" and the "Sources for the Android SDK" items, and click "Install packages...".
Once complete, under eclipse's "Package Explorer", right-click on "AndorsTrail/Android 4.3/android.jar" (you Android version may vary) and select "Build Path->Configure Build Path...".
In the opened "AndorsTrail Project Properties" window, make sure that the "Libraries" tab is select, and expand the "Android 4.3/android.jar" node.
Select "Javadoc location", and click on "Edit...". Make sure "Javadoc URL" is selected, and click on "Browse...". Navigate to "<ADT Root>/sdk/docs/reference/" and click Ok. Click "Ok" in the other window as well.
Now, select "Source attachment" (above "Javadoc location"), and click on "Edit...". Select "External location" and click on "External folder...". Navigate to "<ADT Root>/sdk/sources/android-18/" and click "Ok". Click "Ok" in the other window as well.
Finally, click yet again on the "Ok" button to close the "AndorsTrail Project Properties" window.
Congratulations, you can now place your mouse cursor over any Android class or method name and see its documentation, and hit F3 when the cursor is in an Android class or method name to view its source.
v0.8.10 (BWM fill) released to Google Play!
Useful links
Source code of the game - Contribution guide - ATCS Editor - Translate the game on Weblate - Example walkthrough - Andor's Trail Directory - Join the Discord
Get the game (v0.8.10) from Google, F-Droid, our server, or itch.io
Useful links
Source code of the game - Contribution guide - ATCS Editor - Translate the game on Weblate - Example walkthrough - Andor's Trail Directory - Join the Discord
Get the game (v0.8.10) from Google, F-Droid, our server, or itch.io
Contributing to Andor's Trail - Contribution Guide
- Zukero
- Lead Developer
- Posts: 2028
- Joined: Thu Jul 21, 2011 9:56 am
- android_version: 8.0
- Location: Eclipse
Appendix B - View Javadoc and/or sources of the Android API
Lvl: 78, XP: 8622632, Gold: 271542, RoLS: 1, ElyR: -, RoL: -, ChaR: 1, GoLF: 1, ShaF: 1, SRoV: 1, VSH: 1, WMC: 1, GoW: 1
HP: 71, AC: 301%, AD: 38-47, AP: 3, ECC: 50%, CM: 3.75, BC: 101%, DR: 2
HP: 71, AC: 301%, AD: 38-47, AP: 3, ECC: 50%, CM: 3.75, BC: 101%, DR: 2
- Moerit
- VIP
- Posts: 107
- Joined: Wed Oct 16, 2013 6:44 pm
- android_version: 4.1 - Jellybean
Re: Contributing to Andor's Trail
After reading through all the suggestioned parts about git, i still had problems coming clear with eclipse.
I would like to suggest the following tutorial for all people who are not familiar with git and eclipse:
English Version
German Version
I would like to suggest the following tutorial for all people who are not familiar with git and eclipse:
English Version
German Version
Lvl: 16, XP: 47538, Gold: 474, RoLS: 0, ElyR: 0, RoL: 0, ChaR: 0, GoLF: 0, ShaF: 0, SRoV: 0, VSH: 0, WMC: 0, GoW: 0
HP: 151, AC: 248%, AD: 29-40, AP: 4, ECC: 22%, CM: -, BC: 160%, DR: 5
HP: 151, AC: 248%, AD: 29-40, AP: 4, ECC: 22%, CM: -, BC: 160%, DR: 5
-
- Posts: 38
- Joined: Wed Apr 23, 2014 10:20 am
- android_version: 2.3 - Gingerbread
Re: Contributing to Andor's Trail
I just wanted to add that I can run the emulator on a dual core i7 with almost native speed. Animations are a tad slower than on my device, but not by much. Maybe 80-90% speed. It's important to emulate an x86 atom though ...
-
- Posts: 69
- Joined: Sat Feb 23, 2019 6:10 am
- android_version: 7.1 - Nougat
Re: Contributing to Andor's Trail - Contribution Guide
is the API version still 19? I've noticed some warning on some property that it works from 21 up. it builds and runs, though.
- Zukero
- Lead Developer
- Posts: 2028
- Joined: Thu Jul 21, 2011 9:56 am
- android_version: 8.0
- Location: Eclipse
Re: Contributing to Andor's Trail - Contribution Guide
Nope. I think it's 24 currently...
Lvl: 78, XP: 8622632, Gold: 271542, RoLS: 1, ElyR: -, RoL: -, ChaR: 1, GoLF: 1, ShaF: 1, SRoV: 1, VSH: 1, WMC: 1, GoW: 1
HP: 71, AC: 301%, AD: 38-47, AP: 3, ECC: 50%, CM: 3.75, BC: 101%, DR: 2
HP: 71, AC: 301%, AD: 38-47, AP: 3, ECC: 50%, CM: 3.75, BC: 101%, DR: 2
-
- Posts: 69
- Joined: Sat Feb 23, 2019 6:10 am
- android_version: 7.1 - Nougat
Re: Setup the build environment
May I suggest editing this post?Zukero wrote: ↑Sun Jan 26, 2014 11:09 pm
Unless you are very lucky, you should see in the "Console" tab at the bottom (remember, the "feedback area") a message in red like the following:This means that you do not have the android SDK that matches the one currently used by Andor's Trail.Code: Select all
[2014-01-22 11:48:43 - AndorsTrail] Unable to resolve target 'android-19'
Note what target the message references. In my example, it is "android-19", meaning I need version 19 of the SDK.
If you are lucky, and do not see this message, you can be sure it will appear someday when we upgrade the project to a newer one. So read the next steps anyway.
![Smile :)](./images/smilies/icon_e_smile.gif)
-
- Posts: 192
- Joined: Mon Mar 04, 2019 8:45 pm
- android_version: 8.1 - Oreo
List of quests or features where I could help
Hello, I hope you can help me.
I really like the game and want to give something back to the community. I would like to start with some simple tasks like fixing smaller bugs, translating or helping someone to create game content for his quest.
The bugs on github are very few and the german translations are all done. Is there a list of features or quests or something else, that is currently developed or planned and where I could help?
Thanks
Chris
I really like the game and want to give something back to the community. I would like to start with some simple tasks like fixing smaller bugs, translating or helping someone to create game content for his quest.
The bugs on github are very few and the german translations are all done. Is there a list of features or quests or something else, that is currently developed or planned and where I could help?
Thanks
Chris
- rijackson741
- Posts: 4451
- Joined: Tue Aug 20, 2013 2:04 am
- android_version: 10 - Android 10
- Location: Somewhere in Dhayavar
- Contact:
Re: Contributing to Andor's Trail - Contribution Guide
Hello Gonk, and welcome to the forums.
We always appreciate help! The first thing you should do is download and install ATCS and Tiled. See the first post of this thread, and here: viewtopic.php?f=6&t=4806. Also look at the developers section of the wiki, here: wiki/test/andors_trail_wiki.html. Note that it is very out of date, especially regarding the content editor, but it nevertheless has useful information. Then just play around a little to get the hang of content creation. Edit a few existing maps to get the hang of Tiled, and learn how maps are built. Create a few items, monsters, NPCs with a small dialogue etc to learn the basics of content creation in ATCS. view all of this material as throw-away, and just a learning experience.
Then, start small. IMHO too many potential contributors give up because they try too much for their first project. You do not even need to add a quest to add something useful. For example, just a couple of maps, with an NPC you can trade with for some new items. That would be a complete piece of content we could add to the game. I added the watchtower for the last release. It's only one outside map and two inside maps, but it added something different, which makes the game more interesting. Once you get the hang of small pieces of content you can build up to bigger ones. Someone needs to work on Feygard
And don't be afraid to ask questions if you get stuck!
It's probably a good idea to PM the dev team with new content before you create too much of it. We can tell you what you are doing right and what you are doing wrong before you invest too much time on something that requires large changes.
We always appreciate help! The first thing you should do is download and install ATCS and Tiled. See the first post of this thread, and here: viewtopic.php?f=6&t=4806. Also look at the developers section of the wiki, here: wiki/test/andors_trail_wiki.html. Note that it is very out of date, especially regarding the content editor, but it nevertheless has useful information. Then just play around a little to get the hang of content creation. Edit a few existing maps to get the hang of Tiled, and learn how maps are built. Create a few items, monsters, NPCs with a small dialogue etc to learn the basics of content creation in ATCS. view all of this material as throw-away, and just a learning experience.
Then, start small. IMHO too many potential contributors give up because they try too much for their first project. You do not even need to add a quest to add something useful. For example, just a couple of maps, with an NPC you can trade with for some new items. That would be a complete piece of content we could add to the game. I added the watchtower for the last release. It's only one outside map and two inside maps, but it added something different, which makes the game more interesting. Once you get the hang of small pieces of content you can build up to bigger ones. Someone needs to work on Feygard
![Laughing :lol:](./images/smilies/icon_lol.gif)
And don't be afraid to ask questions if you get stuck!
It's probably a good idea to PM the dev team with new content before you create too much of it. We can tell you what you are doing right and what you are doing wrong before you invest too much time on something that requires large changes.
Level:71, XP:6493739, PV:608, FQ:84
HP:210, AC:212, AD:58-77, AP:4, ECC:16%, CM:1.5, BC:188, DR:3
Gold: 237559 | RoLS:1, RoL:1, GoW:1, VSH:1, RoFLS:1, WoB:1
HH:1, WA:1, CS:2, Cl:1, IF:4, Ev:3, Re:2, WP:DA:1, WP:1S:1, WP:B:1, AP:L:1, FS:DW:2, S:DW:1
HP:210, AC:212, AD:58-77, AP:4, ECC:16%, CM:1.5, BC:188, DR:3
Gold: 237559 | RoLS:1, RoL:1, GoW:1, VSH:1, RoFLS:1, WoB:1
HH:1, WA:1, CS:2, Cl:1, IF:4, Ev:3, Re:2, WP:DA:1, WP:1S:1, WP:B:1, AP:L:1, FS:DW:2, S:DW:1
- Zukero
- Lead Developer
- Posts: 2028
- Joined: Thu Jul 21, 2011 9:56 am
- android_version: 8.0
- Location: Eclipse
Re: Contributing to Andor's Trail - Contribution Guide
If you want to have a first contact with the code, adding the "random" requirement type to dialogue replies is a rather easy task, completed with a couple of lines only.
Once done, there's also the integration of this in ATCS which is about as easy.
As stated by rijackson741 above, content creation is what we need most, but code contributions are appreciated too.
Once done, there's also the integration of this in ATCS which is about as easy.
As stated by rijackson741 above, content creation is what we need most, but code contributions are appreciated too.
Lvl: 78, XP: 8622632, Gold: 271542, RoLS: 1, ElyR: -, RoL: -, ChaR: 1, GoLF: 1, ShaF: 1, SRoV: 1, VSH: 1, WMC: 1, GoW: 1
HP: 71, AC: 301%, AD: 38-47, AP: 3, ECC: 50%, CM: 3.75, BC: 101%, DR: 2
HP: 71, AC: 301%, AD: 38-47, AP: 3, ECC: 50%, CM: 3.75, BC: 101%, DR: 2
-
- Posts: 192
- Joined: Mon Mar 04, 2019 8:45 pm
- android_version: 8.1 - Oreo
Re: Contributing to Andor's Trail - Android Studio
Thanks for your help.
I downloaded the sources and played with tiled and ATCS. My next step was to use Android Studio to build the project. Maybe using Android Studio was a mistake, because I had some issues that I could resolve, but now I am stuck because of the error "mergeDebugResources \xml\blackwater_mountain0.tmx: file name must end with .xml". Is there a current tutorial how to build AT with Android Studio or should I better switch to Eclipse?
Thanks again.
I downloaded the sources and played with tiled and ATCS. My next step was to use Android Studio to build the project. Maybe using Android Studio was a mistake, because I had some issues that I could resolve, but now I am stuck because of the error "mergeDebugResources \xml\blackwater_mountain0.tmx: file name must end with .xml". Is there a current tutorial how to build AT with Android Studio or should I better switch to Eclipse?
Thanks again.