</ul>
</li>
<li><a class="opensection" href="#remove">Removing an Account</a></li>
- <li><a class="opensection" href="#disconnect">Disconnecting from the Account Service</a></li>
+ <li><a class="opensection" href="#disconnect">Destroy the Account Handle</a></li>
<li><a class="opensection" href="#screen">Adding an Application on the Account Screen</a></li>
<li><a class="opensection" href="#queries">Performing Database Queries</a></li>
<li><a class="opensection" href="#secret">Managing Account Secrecy</a></li>
<li><a class="opensection" href="#update">Updating Accounts</a></li>
- <li><a class="opensection" href="#type">Managing Account Types</a></li>
+ <li><a class="opensection" href="#type">Retrieving Account Types</a></li>
</ul>
<p class="toc-title">Related Info</p>
<ul class="toc">
<h1>Account Manager: Managing Account Information on the Device</h1>
<div class="cont"><div class="static-cont">
- <p>This tutorial demonstrates how you can connect to and disconnect from the Account Service, create, delete, and update accounts in the account database, and manage account information, such as user name, display name, domain name, and email address.</p>
+ <p>This tutorial demonstrates how you can create, delete, and update accounts in the account database, and manage account information, such as user name, display name, domain name, and email address.</p>
<h2>Warm-up</h2>
<p>Become familiar with the Account Manager API basics by learning about:</p>
</li>
<li><a class="opensection" href="#remove">Removing an Account</a>
<p>Remove an account from the database.</p></li>
- <li><a class="opensection" href="#disconnect">Disconnecting from the Account Service</a>
- <p>Destroy the account handle and disconnect from the service.</p></li>
+ <li><a class="opensection" href="#disconnect">Destroy the Account Handle</a>
+ <p>Destroy the account handle.</p></li>
<li><a class="opensection" href="#screen">Adding an Application on the Account Screen</a>
<p>Display your application on the Add account screen of a Tizen device.</p>
</li>
<p>Manage account secrecy levels.</p></li>
<li><a class="opensection" href="#update">Updating Accounts</a>
<p>Update account details.</p></li>
- <li><a class="opensection" href="#type">Managing Account Types</a>
- <p>Manage account types.</p></li>
+ <li><a class="opensection" href="#type">Retrieving Account Types</a>
+ <p>Retrieve account types.</p></li>
</ul>
<span class="fr"><a href="#" class="bt-arr"><em>Hide</em></a></span>
</div>
<div class="devicespec-con">
-<p>To connect to the Account Service, create an account, set it properties, and add it to the account database:</p>
+<p>To create an account, set it properties, and add it to the account database:</p>
<ol>
-<li>To operate on the account database, connect the application with the Account Service using the <span style="font-family: Courier New,Courier,monospace;">account_connect()</span> function:
-<pre class="prettyprint">
-ret = account_connect();
-</pre>
-</li>
-
<li>Create an account using the <span style="font-family: Courier New,Courier,monospace;">account_create()</span> function and the previously defined account handle:
<pre class="prettyprint">
<div class="devicespec-con">
<p>To retrieve accounts by a specific account provider:</p>
<ol>
- <li>Connect with the Account Service using the <span style="font-family: Courier New,Courier,monospace">account_connect()</span> function.</li>
<li>Define the <span style="font-family: Courier New,Courier,monospace">account_cb()</span> callback for getting data of accounts as a parameter of the <span style="font-family: Courier New,Courier,monospace">account_query_account_by_package_name()</span> function.
<pre class="prettyprint">
static bool account_callback(account_h account, void* user_data) // account_cb() callback
<div class="devicespec-con">
<p>To retrieve account providers by a specific capability:</p>
<ol>
- <li>Connect with the Account Service using the <span style="font-family: Courier New,Courier,monospace">account_connect()</span> function.</li>
<li>Define <span style="font-family: Courier New,Courier,monospace">account_type_cb()</span> callback for getting account providers as a parameter of the <span style="font-family: Courier New,Courier,monospace">account_type_query_by_provider_feature()</span> function. The callback takes the account provider handle as the first parameter.
<pre class="prettyprint">
static bool account_type_callback(account_type_h account_type, void* user_data) // account_type_cb() callback
<li>Retrieve the account providers of a specific capability by using the <span style="font-family: Courier New,Courier,monospace">account_type_query_by_provider_feature()</span> function:
<pre class="prettyprint">
-account_type_h account_type = NULL;
int ret = -1;
char* capability = "http://tizen.org/account/capability/contact";
-ret = account_type_create(&account_type);
-
-ret = account_type_query_by_provider_feature(account_type_callback, capability, account_type);
+ret = account_type_query_by_provider_feature(account_type_callback, capability, NULL);
</pre></li>
</ol>
</div>
</li>
<li>
<div class="devicespec-tit">
- <h2 id="disconnect" name="disconnect" class="items-tit-h2">Disconnecting from the Account Service</h2>
+ <h2 id="disconnect" name="disconnect" class="items-tit-h2">Destroy the Account Handle</h2>
<span class="fr"><a href="#" class="bt-arr"><em>Hide</em></a></span>
</div>
<div class="devicespec-con">
-<p>To disconnect from the Account Service:</p>
+<p>To destroy the Account Handle:</p>
<ol>
<li>To destroy the account handle, use the <span style="font-family: Courier New,Courier,monospace;">account_destroy()</span> function:
ret = account_destroy(account);
</pre>
</li>
-<li>To disconnect from the Account Service, use the <span style="font-family: Courier New,Courier,monospace;">account_disconnect()</span> function:
-<pre class="prettyprint">
-ret = account_disconnect();
-</pre>
-</li>
</ol>
</div>
</li>
<ol>
-<li>Connect the application with the Account Service using the <span style="font-family: Courier New,Courier,monospace;">account_connect()</span> function:
-
-<pre class="prettyprint">
-ret = account_connect();
-</pre>
-</li>
<li>Prepare sample content.
<p>To perform queries, you need existing content in the database. To access existing account, obtain it from the database. It can be done using a few functions, depending on the user requirements.</p>
<p>To create new content to the database:</p>
int id[3];
static account_h account = NULL;
-create_Account(&account, "Person", "DiplayPerson", "Person Domain", "someone1@somewho.com");
+Create_Account(&account, "Person", "DiplayPerson", "Person Domain", "someone1@somewho.com");
account_set_capability(account, "Custom", ACCOUNT_CAPABILITY_ENABLED);
account_destroy(account);
Create_Account(&account, "LastOne", "LastDisplay", "Last Domain", "someone4@somewho.com");
-account_insert_to_db(account, &id[2]);
+account_insert_to_db(account, &id[3]);
account_destroy(account);
</pre>
</li>
char buf[200];
sprintf(buf,"Found capability: %s on state %d\n", capability_type, capability_state);
- return 1;
+ return true;
}
</pre>
</li></ul></li>
<li>Clean up.
-<p>When no longer needed, all handles to accounts have to be destroyed and the connection to the database has to be closed. In addition, the sample application deletes all its accounts.</p>
+<p>When no longer needed, all handles to accounts have to be destroyed.</p>
<pre class="prettyprint">
account_destroy(account);
-
-account_foreach_account_from_db(delete_account, NULL);
-
-account_disconnect();
</pre>
</li>
</ol>
<div class="devicespec-con">
<p>To manage account secrecy:</p>
<ol>
-<li>Connect the application with the Account Service using the <span style="font-family: Courier New,Courier,monospace;">account_connect()</span> function:
-
-<pre class="prettyprint">
-ret = account_connect();
-</pre>
-</li>
<li>Select the secrecy level using the <a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__ACCOUNT__MANAGER__MODULE.html#ga41a7e7e7cfb072d0b0ba37087a0535b6">account_secrecy_state_e</a> enumeration.
<pre class="prettyprint">
List_Accounts(NULL);
-account_foreach_account_from_db(delete_account, NULL);
</pre>
<p>Secrecy is linked only with visibility on the account settings screen. The account is still visible and can be accessed using a query or the <span style="font-family: Courier New,Courier,monospace;">for_each</span> function. For further information on how to add your application to the account screen, see the <a href="account_tutorial_n.htm">Account Tutorial</a>.</p>
</li>
<li>Clean up.
-<p>Account handles have to be destroyed when not needed anymore. Accounts are removed from the database. The connection has to be terminated.</p>
+<p>Account handles have to be destroyed when not needed anymore.</p>
<pre class="prettyprint">
account_destroy(account);
-
-account_foreach_account_from_db(delete_account, NULL);
-
-account_disconnect();
</pre>
</li>
</ol>
<p>To update and track account data.</p>
<ol>
-<li>Connect the application with the Account Service using the <span style="font-family: Courier New,Courier,monospace;">account_connect()</span> function:
-
-<pre class="prettyprint">
-ret = account_connect();
-</pre>
-</li>
<li>Subscribe notifications.
<p>To track account changes, create an <span style="font-family: Courier New,Courier,monospace;">account_subscribe_h</span> instance and register a notification.</p>
<pre class="prettyprint">
-account_type_h account_type;
account_subscribe_h account_subscribe;
account_subscribe_create(&account_subscribe);
sprintf(buf, "ACCOUNT EVENT: %s, %d\n", event_type, account_id);
- return 1;
+ return true;
}
</pre>
</li>
<pre class="prettyprint">
account_unsubscribe_notification(account_subscribe);
-
-account_destroy(account);
-
-account_foreach_account_from_db(delete_account, NULL);
</pre>
</li>
</ol>
</li>
<li>
<div class="devicespec-tit">
- <h2 id="type" name="type" class="items-tit-h2">Managing Account Types</h2>
+ <h2 id="type" name="type" class="items-tit-h2">Retrieving Account Types</h2>
<span class="fr"><a href="#" class="bt-arr"><em>Hide</em></a></span>
</div>
<div class="devicespec-con">
-<p>To manage account types:</p>
+<p>To retrieve account types:</p>
<ol>
-<li>Connect the application with the Account Service using the <span style="font-family: Courier New,Courier,monospace;">account_connect()</span> function:
-
-<pre class="prettyprint">
-ret = account_connect();
-</pre>
-</li>
<li>Create a type.
<p>To operate on the account type, create a handle to it.</p>
</pre>
</li>
-<li>Add the type.
-<p>If the account type with a specified ID does not exists, it can be added to the database.</p>
+<li>Get the type information.
+<p>If the account type with a specified ID exists, it can be gotten from the database by account_query_by_app_id() API.</p>
<p>It is possible to set, for example:</p>
<ul class="ul">
<li>Multiple account support (this is only a flag)</li>
</ul>
-<p>After all the options are set, the account type has to be added to the database.</p>
+<p>To get the account types by app id, account_type_query_by_app_id() API is provided.</p>
<pre class="prettyprint">
-if (account_type_query_app_id_exist(type_id))
+int multiple_account_support = -1;
+char *your_app_id = "com.tizen.example"; // A app id retrieving acccount types
+char *app_id = NULL;
+char *provider_feature = NULL;
+char *icon_path = NULL;
+
+if (account_type_query_app_id_exist(your_app_id))
{
- account_type_set_app_id(account_type, type_id);
+ account_type_query_by_app_id(your_app_id, &account_type);
- account_type_set_multiple_account_support(account_type, true);
+ account_type_get_app_id(account_type, &app_id);
- account_type_set_label(account_type, "TestLable", "TestLocale");
+ account_type_get_multiple_account_support(account_type, &multiple_account_support);
- account_type_set_provider_feature(account_type, "Example Feature");
+ account_type_get_icon_path(account_type, &icon_path);
- account_type_insert_to_db(account_type, &id);
+ account_type_get_provider_feature(account_type, &provider_feature);
}
</pre>
</li>
<p>While listing the labels, the user has access to the ID of the account type, label and its local value, and the user data passed while casting the query function.</p>
<pre class="prettyprint">
-bool _account_label_cb(char *id, char *label, char *locale, void *user_data)
+bool _account_label_cb(char *app_id, char *label, char *locale, void *user_data)
{
char buf[200];
sprintf(buf,"Get Label ID: %s LABEL: %s LOCALE %s\n", app_id, label, locale);
- return 1;
+ return true;
}
</pre>
account_type_get_multiple_account_support(account_type, &support);
sprintf(buf,"Account Type ID: %s Multiple support %d:\n", id, support);
- return 1;
+ return true;
}
</pre>
</li>
<li>Clean up.
-<p>All allocated handles have to be destroyed. The account type is also removed. The connection to the database has to be closed.</p>
+<p>All allocated handles have to be destroyed.</p>
<pre class="prettyprint">
-account_type_delete_by_app_id(type_id);
+free(app_id);
+free(provider_feature);
+free(icon_path);
account_type_destroy(account_type);
-
-account_disconnect();
</pre>
</li>
</ol>
</script>
</body>
-</html>
\ No newline at end of file
+</html>
projects / sdk / online-doc.git / commitdiff