【Android API】ShareCompat.IntentBuilder机翻+手翻

1，java.lang.Object
--->> android.support.v4.app.ShareCompat.IntentBuilder
android.support.v4 jar包下。
2，Class Overview 概述
IntentBuilder is a helper for constructing ACTION_SEND and ACTION_SEND_MULTIPLE sharing intents and starting activities to share content. The ComponentName and package name of the calling activity will be included.
IntentBuilder 构造一个ACTION_SEND和ACTION_SEND_MULTIPLE 分享意图并且开启activity的帮助类，用来分享内容。调用activity的单元和包名也将包括在内。
3， Public Methods 公共方法
1：public ShareCompat.IntentBuilder addEmailBcc (String[] addresses)
Add an array of email addresses to be used in the "bcc" field of the final Intent.
添加一个bcc（复制密件 - blind carbon copied）的邮件地址数组到意图。
Parameters
addresses Email addresses to BCC
用来抄送的Email。
Returns
This IntentBuilder for method chaining
返回一个IntentBuilder的方法链接。
2：public ShareCompat.IntentBuilder addEmailBcc (String address)
同“1”，这里的参数不是数组，而是一个邮件地址字符串；
3：public ShareCompat.IntentBuilder addEmailCc (String[] addresses)

Add an array of email addresses to be used in the "cc" field of the final Intent.
添加一个cc（抄送 - carbon copied）的邮件地址数组到意图。
Parameters
addresses Email addresses to CC
Returns
This IntentBuilder for method chaining
4：public ShareCompat.IntentBuilder addEmailCc (String address)
同“3”，参数为字符串；
5：public ShareCompat.IntentBuilder addEmailTo (String[] addresses)
Add an array of email addresses to be used in the "to" field of the final Intent.
添加一个群发邮件地址数组到意图。
Parameters
addresses Email addresses to send to
Returns
This IntentBuilder for method chaining
6：public ShareCompat.IntentBuilder addEmailCc (String address)
同“5”
7：public ShareCompat.IntentBuilder addStream (Uri streamUri)

Add a stream URI to the data that should be shared. If this is not the first stream URI added the final intent constructed will become an ACTION_SEND_MULTIPLE intent. Not all apps will handle both ACTION_SEND and ACTION_SEND_MULTIPLE.
添加要共享的数据流的URI。如果这不是第一个被添加到意图的流，那么这个意图会是一个ACTION_SEND_MULTIPLE意图。
并不是所有应用将同时持有ACTION_SEND,ACTION_SEND_MULTIPLE.
Parameters
streamUri URI of the stream to share 要分析的数据流的URI
Returns
This IntentBuilder for method chaining
ACTION_SEND:
Activity Action: Deliver some data to someone else. Who the data is being delivered to is not specified; it is up to the receiver of this action to ask the user where the data should be sent.
活动的动作，提供一些数据去其他人。数据被提供给谁并没有被指定，这决定于接收者的动作的要求，这些数据应该被发送给谁。
When launching a SEND intent, you should usually wrap it in a chooser (through createChooser(Intent, CharSequence)), which will give the proper interface for the user to pick how to send your data and allow you to specify a prompt indicating what they are doing.
当启动一个意图，你通常应该把它包含在一个选择器中（通过creatChooser(Intent,CharSequence))方法），这将给用户一个合适的接口去选择怎样把你的数据发送，并且允许你指定一个提示表示他们在做什么。
Input: getType() is the MIME type of the data being sent. get*Extra can have either a EXTRA_TEXT or EXTRA_STREAM field, containing the data to be sent. If using EXTRA_TEXT, the MIME type should be "text/plain"; otherwise it should be the MIME type of the data in EXTRA_STREAM. Use */* if the MIME type is unknown (this will only allow senders that can handle generic data streams). If using EXTRA_TEXT, you can also optionally supply EXTRA_HTML_TEXT for clients to retrieve your text with HTML formatting.
输入：getType()是将被发送的数据的MIME类型。
get*Extra()可以有EXTRA_TEXT或EXTRA_STREAM字段，包含要发送的数据；
如果使用EXTRA_TEXT,MIME类型应该是"text/plain";否则MIME类型是EXTRA_STREAM.
使用*/*如果MIME的类型未知（这将仅仅允许发送者只能处理一般的数据流）；
如果使用EXTRA_TEXT,你也可以为用户提供EXTRA_HTML_TEXT，从html中获取文字。
As of JELLY_BEAN, the data being sent can be supplied through setClipData(ClipData). This allows you to use FLAG_GRANT_READ_URI_PERMISSION when sharing content: URIs and other advanced features of ClipData. If using this approach, you still must supply the same data through the EXTRA_TEXT or EXTRA_STREAM fields described below for compatibility with old applications. If you don't set a ClipData, it will be copied there for you when calling startActivity(Intent).
和4.0一样，将发送的数据可以通过setClipData(ClipData)来提供。这允许你在分享的时候，使用FLAG_GRANT_READ_URI_PERMISSION,URI和其他先进功能。若使用这种方法，你必须通过下文所述的与旧应用程序的兼容性EXTRA_TEXT或EXTRA_STREAM领域提供相同的数据。如果你没有设置ClipData，他将被复制在那，当你开启活动的时候。
Optional standard extras, which may be interpreted by some recipients as appropriate, are: EXTRA_EMAIL, EXTRA_CC, EXTRA_BCC, EXTRA_SUBJECT.
可选的额外标准：EXTRA_EMAIL,EXTRA_CC,EXTRA_BCC,EXTRA_SUBJECT;
8: public Intent createChooserIntent ()
Create an Intent that will launch the standard Android activity chooser, allowing the user to pick what activity/app on the system should handle the share.
创建一个意图，将推出标准的android活动选择器，允许选择什么样的安装在系统上的activity/app处理分享。
Returns
A chooser Intent for the currently configured sharing action
9：public static ShareCompat.IntentBuilder from (Activity launchingActivity)
Create a new IntentBuilder for launching a sharing action from launchingActivity.
从当前上下文，创建一个新的IntentBuilder去执行分享动作。
10：public Intent getIntent ()
Retrieve the Intent as configured so far by the IntentBuilder. This Intent is suitable for use in a ShareActionProvider or chooser dialog.
检索所有由IntentBuilder配置的意图。该意图适用在ShareActionProvider或chooser dialog；
To create an intent that will launch the activity chooser so that the user may select a target for the share, see createChooserIntent().
要创建一个意图去启动activity选择器，使用户可以选择目标去分享，见creatChooserIntent();
11：public ShareCompat.IntentBuilder setChooserTitle (int resId)
Set the title that will be used for the activity chooser for this share.
设置将被使用的activity 选择器的title。
12：public ShareCompat.IntentBuilder setEmailBcc (String[] addresses)
Set an array of email addresses to BCC on this share. This replaces all current "BCC" recipients that have been set so far.
见“1”；
13：public ShareCompat.IntentBuilder setEmailCc (String[] addresses)
见“3”
14：public ShareCompat.IntentBuilder setEmailTo (String[] addresses)
见“5”
15：public ShareCompat.IntentBuilder setHtmlText (String htmlText)
Set an HTML string to be sent as part of the share. If EXTRA_TEXT has not already been supplied, a styled version of the supplied HTML text will be added as EXTRA_TEXT as parsed by Html.fromHtml.
设置Html字符串为将要发出的分享的一部分。如果EXTRA_TEXT没有被提供，一个支持Html的并且被Html.fromHtml解析的文本样式版本将要被添加为EXTRA_TEXT。
16：public ShareCompat.IntentBuilder setStream (Uri streamUri)
Set a stream URI to the data that should be shared.
设置要分析的数据流的URI。
This replaces all currently set stream URIs and will produce a single-stream ACTION_SEND intent.
这将替换当前所有设置的流的URI，并且将产生一个单流ACTION_SEND意图。
17：public ShareCompat.IntentBuilder setSubject (String subject)
Set a subject heading for this share; useful for sharing via email.
设置一个共享的主题词，对电子邮件分享很有用。
18：public ShareCompat.IntentBuilder setText (CharSequence text)
Set the literal text data to be sent as part of the share. This may be a styled CharSequence.
设置文字数据作为分享的一部分。这也许是个格式化的CharSequence。
19：public ShareCompat.IntentBuilder setType (String mimeType)
Set the type of data being shared
设置要分享的数据的type。
20：public void startChooser ()
Start a chooser activity for the current share intent.
为当前分享意图开启选择activity。
Note that under most circumstances you should use ShareCompat.configureMenuItem() to add a Share item to the menu while presenting a detail view of the content to be shared instead of invoking this directly.
请注意，在大多数情况下，你应该使用ShareCompat.configureMenuItem()来添加一个分享条目到menu并且呈现一个详细视图。
而不是直接调用此方法。