2 #ifndef h_pnd_discovery_h
3 #define h_pnd_discovery_h
9 // this code is for doing the application discovery against a given directory and its children (ie: this
10 // code could be called on appliction startup, or as a result of media eject/insert, and so forth.)
12 /* disco_search() will walk the given search path (one or more paths, colon separated) in order left to
13 * right; as PXML's are found, basic analysis is performed to verfy validity. A list of valid applications
14 * is returned, the union of all matches in the search path
15 * If no matches are found, NULL is returned (to save you deleting the container)
16 * overridespath may be NULL if you do not wish to search for pxml overrides
18 pnd_box_handle pnd_disco_search ( char *searchpath, char *overridespath );
20 /* pnd_disco_t describes a given entry found by the discovery code; ie: the containers key is the path to
21 * the PXML file (since this is relatively unique), with the fields below detailing the executable path,
22 * application name, unique-id and so on
24 * NOTE: this struct is dynamicly populated; you are responsible for invoking the destroy() function to
25 * kill its contents, and the pnt_box_destroy() to kill the container at the end
27 * NOTE: The PXML path (or .pnd file path in bundle files) is used as a key since it is unique. The
28 * application 'unique id' will be unique for a given app, but that app could be in multiple directories
29 * or on multiple SD cards or wifi or whatever, so only the mounted path is truly unique. The key
30 * is only used internally so the consumer can refer to multiple versions of the same app without
31 * confusion.. it is not displayed. So no big deal.
34 // another struct? Have always intended discovery_t to have minimal members.. just enough to lead to an
35 // application (PXML, xecutable, name); if the apps want more details, they can use the pnd_pxml code to
36 // fetch the full PXML and get all the details. But I think we got out of control here :)
39 char *path_to_object; // full path to the PXML.xml or awesomeapp.pnd file
50 void pnd_disco_destroy ( pnd_disco_t *p ); // a function name that simply could not be avoided
52 // emit_dotdesktop() will determine a filename and create a FILENAME.desktop file in the targetpath
53 // TODO: Copy the icon into this directory as well, if its source is a .pnd or info is in the dico struct
54 unsigned char pnd_emit_dotdesktop ( char *targetpath, pnd_disco_t *p );
56 // TODO: A way to release the disco-lists and reclaim RAM :)