[IME] migrate the xkb ID to extension based xkb ID.

chrome/browser/chromeos/input_method/input_method_util.h

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef CHROME_BROWSER_CHROMEOS_INPUT_METHOD_INPUT_METHOD_UTIL_H_
 #define CHROME_BROWSER_CHROMEOS_INPUT_METHOD_INPUT_METHOD_UTIL_H_
 
 #include <cstddef>
 #include <map>
 #include <string>
@@ skipping 22 matching lines @@
   // including ones not active. The list is used to initialize member variables
   // in this class.
   InputMethodUtil(InputMethodDelegate* delegate,
                   scoped_ptr<InputMethodDescriptors> supported_input_methods);
   ~InputMethodUtil();
 
   // Converts a string sent from IBus IME engines, which is written in English,
   // into Chrome's string ID, then pulls internationalized resource string from
   // the resource bundle and returns it. These functions are not thread-safe.
   // Non-UI threads are not allowed to call them.
+  // The english_string to should be a xkb id with "xkb:...:...:..." format.
+  // TODO(shuchen): this method should be removed when finish the wrapping of
+  // xkb to extension.
   base::string16 TranslateString(const std::string& english_string) const;
 
   // Converts an input method ID to a language code of the IME. Returns "Eng"
   // when |input_method_id| is unknown.
   // Example: "hangul" => "ko"
   std::string GetLanguageCodeFromInputMethodId(
       const std::string& input_method_id) const;
 
   // Converts an input method ID to a display name of the IME. Returns
   // an empty strng when |input_method_id| is unknown.
@@ skipping 38 matching lines @@
   // Gets the language codes associated with the given input method IDs.
   // The returned language codes won't have duplicates.
   void GetLanguageCodesFromInputMethodIds(
       const std::vector<std::string>& input_method_ids,
       std::vector<std::string>* out_language_codes) const;
 
   // Gets first input method associated with the language.
   // Returns empty string on error.
   std::string GetLanguageDefaultInputMethodId(const std::string& language_code);
 
+  // Migrates the legacy xkb id to extension based xkb id.
+  // Returns true if the given input method id list is modified,
+  // returns false otherwise.
+  // TODO(shuchen): Remove this function after few milestones are passed.
+  // See: http://crbug.com/345604
+  bool MigrateXkbInputMethods(
+      std::vector<std::string>* input_method_ids);
+
   // Updates the internal cache of hardware layouts.
   void UpdateHardwareLayoutCache();
 
   // Set hardware keyboard layout for testing purpose. This is for simulating
   // "keyboard_layout" entry in VPD values.
   void SetHardwareKeyboardLayoutForTesting(const std::string& layout);
 
   // Fills the input method IDs of the hardware keyboard. e.g. "xkb:us::eng"
   // for US Qwerty keyboard or "xkb:ru::rus" for Russian keyboard.
   const std::vector<std::string>& GetHardwareInputMethodIds();
@@ skipping 79 matching lines @@
   std::vector<std::string> hardware_layouts_;
   std::vector<std::string> hardware_login_layouts_;
 
   DISALLOW_COPY_AND_ASSIGN(InputMethodUtil);
 };
 
 }  // namespace input_method
 }  // namespace chromeos
 
 #endif  // CHROME_BROWSER_CHROMEOS_INPUT_METHOD_INPUT_METHOD_UTIL_H_